v1.0.0 • DNS-based Agent Identity & Discovery

_agent Identity & Discovery

DNS for agents. Discover endpoints and verify identity.

_agent.magic.agentTXT →
9 protocols6 SDKsMIT licensed
$npm install @agentcommunity/aid
Core SDK. The CLI wraps the engine.

One _agent TXT record for instant discovery and agent identity you can verify.

example:
_agent.magic.agent. // TXT "v=aid1;uri=https://api.magic.agent/mcp;p=mcp"
protocol:mcp

Quick Start

Discover, publish and validate in minutes

discover
import { discover } from '@agentcommunity/aid'

const { record } = await discover('example.com')
console.log(record.uri) // https://api.example.com/mcp

The Agent/Tooling Integration Problem

Connecting to AI agents shouldn't require a PhD in API archaeology

Manual Integration Hell

Each agent needs bespoke code, doc digging and manual config.

Protocol Fragmentation

Agents speak MCP, A2A, OpenAPI and more — auth flows vary wildly.

Wasted Development Time

Teams lose weeks wiring basic discovery and connection logic.

No Discovery & Identity Standard

No universal way to discover agents and verify who runs them.

How Agent Discovery Solves This

Three simple principles that eliminate integration complexity

1

One DNS TXT Record

Add a single _agent.example.com TXT record. That's it. No registries, no APIs, no complexity.

2

Instant Discovery

Any tool can find your agent by looking up the _agent subdomain. Falls back to .well-known/agent when DNS is restricted.

3

Protocol-Agnostic

Works with any agent protocol — just change the p= token in your record.

mcpa2aopenapigrpcgraphqlwebsocketucp
4

Agent Identity

Publish a public key (PKA) and let clients verify your endpoint using HTTP Message Signatures (Ed25519).

Identity (PKA)

Public Key for Agents: verify that you are connecting to the right endpoint.

How it works

PKA adds a public key (`k`) and a key id (`i`) to your `_agent` TXT record. Clients send a small challenge and verify an HTTP signature from your server using that key.

In short: DNS tells clients where to connect; Identity (PKA) lets clients verify who is on the other end. All keys have single-letter aliases for byte efficiency (e.g. u for uri, p for proto).

  • Publish `k` (public key) and `i` (key id) in your TXT record
  • Client sends an `AID-Challenge` to your `uri`
  • Server returns an HTTP signature (Ed25519) covering the request
  • Client verifies the signature using `k`
txt
_agent.example.com. 300 IN TXT   "v=aid1;\
  uri=https://api.example.com/mcp;\
  p=mcp;\
  k=z7rW8rTq8o4mM6vVf7w1k3m4uQn9p2YxCAbcDeFgHiJ;\
  i=g1"

Complete Developer Toolkit

Everything you need to build AID-powered applications

Tool
Stable

Core Engine

@agentcommunity/aid-engine

Pure business logic for discovery, validation, identity

Discovery
Validation
Identity (PKA)
Tool
Stable

CLI – AID Doctor

@agentcommunity/aid-doctor

CLI wrapper around aid-engine: validate & generate records

Record linting
Security checks
JSON/YAML output
Tool
Stable

Conformance Suite

@agentcommunity/aid-conformance

Golden fixtures and CLI runner for parity checks

Golden fixtures
CLI runner
Cross-language parity
Tool
Stable

Web Workbench

Interactive tool

Try AID in the browser – no install

Live DNS lookup
Shareable links
Export configs
Tool
Planned

Coming soon

more tooling

Open a PR

more tooling
Language support
New ideas
Language
Stable

TypeScript / JS

@agentcommunity/aid

SDK for Node.js & browser

Promise-based API
TypeScript types
Built-in validation
Language
Stable

Go

github.com/agentcommunity/aid-go

High-performance Go client

Context support
No external deps
Language
Stable

Python

aid-discovery

Idiomatic Python client

Type hints
Clean API
Language
Stable

Rust

packages/aid-rs

Idiomatic Rust client

Generated constants
Parser parity
Discovery support
Language
Stable

Java

packages/aid-java

Idiomatic Java client

Generated constants
Parser parity
Discovery support
Language
Stable

.NET

packages/aid-dotnet

C#/.NET client

Generated constants
Parser parity
Discovery support

The Future of AI Integration

Building the infrastructure for the next generation of AI applications

Universal Agent Ecosystem

Imagine a world where every AI service is instantly discoverable. No more hunting through documentation, no more custom integration code. Just type a domain and connect to any agent, anywhere.

  • Cross-platform interoperability
  • Automatic capability discovery
  • Zero-config networking
  • Verifiable agent identity (PKA)

Open-Source Agent Infrastructure

We're building a vendor-neutral stack for hosting, scaling and observing agents. Curious? Get involved at agentcommunity.org.

  • MIT-licensed core
  • Self-host or cloud
  • Token registries & open index
  • Community governance