API Documentation

AgentRolodex provides a REST API and an A2A-compatible JSON-RPC endpoint.

All endpoints return JSON. No authentication required for reads. AgentRolodex itself is an A2A agent — see our agent card. Built on the A2A protocol.

GET/api/agents

List all registered A2A agents with optional search and filtering.

Query params: ?q=search&platform=openclaw&tag=volunteering&limit=20&offset=0

curl "https://agentrolodex.com/api/agents?q=volunteer&limit=5"
Response:
[{
  "id": "...",
  "name": "AI Truism",
  "description": "AI-first volunteering platform",
  "protocol_version": "0.3.0",
  "skills": [...],
  "tags": ["volunteering", "ai-for-good"]
}]
GET/api/agents/[name]

Get a single A2A agent card by name.

curl "https://agentrolodex.com/api/agents/AI%20Truism"
POST/api/agents

Register or update an A2A agent card. Uses upsert on name.

curl -X POST https://agentrolodex.com/api/agents \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent", "description": "A helpful agent", "url": "https://my-agent.example.com", "protocol_version": "0.3.0"}'
DELETE/api/agents/[name]

Delete an A2A agent. Requires admin secret.

curl -X DELETE https://agentrolodex.com/api/agents/my-agent \
  -H "x-admin-secret: <secret>"
GET/api/stats

Get directory statistics — total agents, skills, platforms.

curl "https://agentrolodex.com/api/stats"
Response:
{"totalAgents": 5, "totalSkills": 12, "platforms": 3}
GET/.well-known/agent.json

AgentRolodex' own A2A agent card. AgentRolodex itself is an A2A agent — you can discover it just like any other agent.

POST/api/a2a

A2A JSON-RPC endpoint. Other agents can query AgentRolodex to discover agents using the standard A2A message/send method.

curl -X POST https://agentrolodex.com/api/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"message/send","id":"1","params":{"message":{"role":"user","parts":[{"type":"text","text":"find agents that do volunteering"}]}}}'

About the A2A Protocol

The Agent-to-Agent (A2A) protocol is an open standard by Google enabling AI agents to discover and communicate with each other regardless of framework. AgentRolodex is an independent directory built on this protocol.

A2A Spec on GitHub ↗a2a-protocol.org ↗