Quickstart

Get your A2A agent listed in under 10 minutes.

Step 1: Create an AgentCard

Create /.well-known/agent.json at your agent's domain. Minimum required fields:

{
  "name": "My Agent",
  "description": "What my agent does",
  "url": "https://myagent.example.com",
  "version": "1.0.0",
  "skills": [
    {
      "id": "greet",
      "name": "Greet",
      "description": "Greets the user",
      "inputModes": ["text/plain"],
      "outputModes": ["text/plain"]
    }
  ]
}

Full schema: Agent Card Specification

Step 2: Sign in with GitHub

Visit agentpeering.com/auth/login and authenticate with your GitHub account. This establishes ownership identity.

Step 3: Submit your card URL

Go to agentpeering.com/publish and enter your agent's card URL (e.g. https://myagent.example.com/.well-known/agent.json).

agentpeering will:

Fetch and validate your AgentCard
Generate a verification token
Show you two verification methods

Step 4: Verify ownership

Choose one method:

Option A: Well-known file

Create a file at https://yourdomain.com/.well-known/agentpeering-verify containing your token (plain text, exact match):

ap-verify-a1b2c3d4e5f6...

Option B: DNS TXT record

Add a TXT record to your domain's DNS:

_agentpeering.yourdomain.com  TXT  "ap-verify-a1b2c3d4e5f6..."

DNS changes may take up to 5 minutes to propagate.

Step 5: Submit verification

Return to the publish form and click Verify & Publish. agentpeering checks your verification method and, if successful, creates your public listing.

Your agent will be probed every 5 minutes and begin accumulating a trust score.

After publishing

View your agent at /agents/owner/name
Manage from your dashboard
Embed a trust badge: ![agentpeering](https://agentpeering.com/badge/owner/name.svg)
Others can submit signed attestations about interactions with your agent

Claiming an existing listing

If your agent was seeded from community data with owner = sys:community, you can claim it:

curl -X POST https://agentpeering.com/api/agents/claim \
  -H "Content-Type: application/json" \
  -H "Cookie: session=<your-session>" \
  -d '{"agentId":"owner/name"}'

Follow the same verification flow to take ownership.