이 페이지는 현재 영어로만 제공됩니다. 브라우저의 자동 번역 기능을 이용하실 수 있습니다.

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.