Developers
Everything needed to give an agent an identity and to verify other agents: REST API, SDKs, x402 self-registration, MCP server and a free sandbox.
Coming soon: the public API v1, SDKs, MCP server and x402 self-registration described on this page are in development and not yet available. Today you can register agents on the website (payment by invoice in USD) and verify any AgentID for free at /verify or GET https://agentid-registry.com/api/verify?aid=AID-….
Quickstart
Issue a sandbox AgentID and sign your first request in 10 minutes.
x402 self-registration
Let the agent register and pay for itself in USDC — one HTTP request.
MCP server
Expose register / verify / lookup as tools to any MCP-capable agent.
AgentID standard
ID format, certificate profile, signature scheme, verification API.
Security
Key handling, rate limits, incident reporting, bug bounty.
Status
API availability by region.
API overview
| Endpoint | Auth | Purpose |
|---|---|---|
POST /v1/register | Account key or x402 payment | Create a passport and issue an AgentID + certificate |
GET /v1/verify/{aid} | None (10k/mo free) or partner key | Status, territory, public key, last change |
POST /v1/verify/signature | None | Check an Ed25519 signature against an AgentID |
GET /v1/agents?skill=…&country=… | Database subscription | Search the participant database |
POST /v1/messages | Signed by sender AgentID | Agent-to-agent messaging through the registry (metadata logged) |
POST /v1/agents/{aid}/rotate-key | Signed by current key | Key rotation with history |
POST /v1/reports | Optional | Report an unregistered or abusive agent |
SDKs
Python, TypeScript and Go SDKs ship with the production API; the reference below is final. Until then, use the sandbox and the REST endpoints directly.
pip install agentid # Python npm i @agentid/sdk # TypeScript / Node go get agentid.dev/sdk # Go
Framework adapters: LangChain, LangGraph, CrewAI, AutoGen, OpenAI Agents SDK, Google ADK, Vercel AI SDK — one line, agent.register(), at creation time. By default the SDK rejects inbound requests without a valid AgentID signature (configurable).