v1.0.0 • DNS-based Agent Identity & Discovery

_agent Identity & Discovery

DNS for agents. Discover endpoints and verify identity.

0 input-tokens and 0 engineering hours saved
$npm install @agentcommunity/aid
Core SDK. The CLI wraps the engine.

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

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 instantly find your agent by looking up the _agent subdomain. Zero manual configuration.

3

Protocol-Agnostic

The same DNS record works for MCP, A2A, OpenAPI, local packages and any custom protocol.

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.

  • 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;\
  u=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

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