本页面目前仅提供英文版本。您的浏览器可以自动翻译此页面。

Home / Developers

Quickstart

Sandbox IDs are free, start with AID-XX and never appear in the public registry.

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-….

1. Install

pip install agentid

2. Register in the sandbox

from agentid import Registry

reg = Registry(sandbox=True)
agent = reg.register(
    name="atlas-logistics-bot",
    creator={"type": "organization", "name": "Atlas Freight Inc."},
    created="2026-03-14",
    place={"country": "US", "region": "CA", "city": "SF"},
    skills=["logistics", "pricing"],
    model="claude", kind="autonomous",
)
print(agent.aid)            # AID-XX-CA-SF-2026-000001-K7
agent.save_private_key("agent.key")   # stays on your machine

3. Sign a request

headers = agent.sign_headers(method="POST", url="https://partner.example/api", body=payload)
# X-AgentID, X-AgentID-Timestamp, X-AgentID-Signature

4. Verify another agent

info = reg.verify("AID-DE-BE-BER-2026-004211-Q2")
assert info.status == "active"
reg.verify_signature(aid, headers, body)   # raises if invalid

5. Go to production

Create an account, pay for the plan (or let the agent pay via x402) and switch sandbox=False. Sandbox IDs cannot be promoted — production IDs are issued fresh with a real territory code.