--- title: "Agent Community Developer Resources" description: "Agent Community developer portal: REST API documentation, OpenAPI 3.1 spec, hosted MCP server and A2A endpoint, AID (Agent Identity & Discovery) SDKs on npm and PyPI, and agent-readable site surfaces. Free, no API key required." label: "Developers" template: "feature" projection: "developer-resources" metadataTitle: "Agent Community Developer Resources — API Docs, OpenAPI, MCP Server, SDK & Auth" openGraphDescription: "Agent Community developer portal: REST API documentation, OpenAPI 3.1 spec, hosted MCP server and A2A endpoint, AID (Agent Identity & Discovery) SDKs on npm and PyPI, and agent-readable site surfaces. Free, no API key required." structuredData: - breadcrumb - web-api --- # Agent Community Developer Resources Everything you need to build against Agent Community: REST **API documentation**, an **OpenAPI spec**, a hosted **MCP server**, an **A2A endpoint**, and the AID (Agent Identity & Discovery) SDKs. Public reads are free, and the optional no-write contract simulator provides fixed parser fixtures. ## API documentation The REST API is documented in full at [/docs/api-reference](/docs/api-reference), with a machine-readable [OpenAPI 3.1 spec](/openapi.json) and an [RFC 9727 api-catalog entry](/.well-known/api-catalog) for discovery. ```bash curl "https://agentcommunity.org/api/v1/content?q=agent&type=docs&limit=20" ``` ## Bounded public-read batch `POST /api/v1/batch` combines `content.list` and `docs.ask` public reads in one ordered request. It accepts at most 10 operations and 262144 request bytes. The anonymous trusted-IP policy allows 10 requests per 60 seconds. A 10-second execution deadline begins when validated execution starts. No later operation starts after that deadline; work already running may finish. Invalid operations and arguments are returned as ordered item-level errors without discarding valid siblings. ```bash curl -X POST https://agentcommunity.org/api/v1/batch \ -H "Content-Type: application/json" \ --data '{"items":[{"id":"content-1","operation":"content.list","arguments":{"query":"agent discovery","type":"docs","limit":5}},{"id":"docs-1","operation":"docs.ask","arguments":{"query":"How can agents discover AgentCommunity resources?","top_k":3}}]}' ``` ## Contract simulator The [no-write workbench](/sandbox) runs four deterministic fixture scenarios through [POST /api/v1/sandbox/simulate](/api/v1/sandbox/simulate). It shares production response schemas while using fixed synthetic values and never reads member data, calls production services, signs credentials, or performs writes. - `agent_auth_challenge` — Synthetic service authorization challenge. - `agent_auth_pending` — Synthetic authorization-pending OAuth response. - `agent_auth_success` — Synthetic approved agent authorization response. - `batch_mixed_result` — Synthetic mixed public-read batch response. ```bash curl -X POST https://agentcommunity.org/api/v1/sandbox/simulate \ -H "Content-Type: application/json" \ --data '{"scenario":"agent_auth_challenge"}' ``` ## MCP server A hosted [MCP server](/docs/mcp-server) is available at [agentcommunity.org/mcp](https://agentcommunity.org/mcp), with a [manifest](/.well-known/mcp) and a server card describing available tools. For published documentation only, use the separate read-only [Documentation MCP](/docs/docs-mcp) at [agentcommunity.org/mcp/docs](https://agentcommunity.org/mcp/docs). Its [discovery manifest](/.well-known/mcp-docs.json) and [compatibility-discovery card](/.well-known/mcp-docs/server-card.json) do not expose product tools or member data. Both servers speak protocol revision `2026-07-28` and the older revisions on the same endpoint, choosing per request. Existing SDKs use the `initialize` handshake and are unaffected; a `2026-07-28` client sends `server/discover` with the standard MCP headers instead. Details are in the [MCP server docs](/docs/mcp-server). ```bash # legacy handshake curl -X POST https://agentcommunity.org/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}' # 2026-07-28 discovery curl -X POST https://agentcommunity.org/mcp \ -H "Content-Type: application/json" \ -H "MCP-Protocol-Version: 2026-07-28" \ -H "Mcp-Method: server/discover" \ -d '{"jsonrpc":"2.0","id":2,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}' ``` ## Documentation answers (NLWeb) For deterministic, cited answers from published documentation, use the [NLWeb-compatible documentation answer endpoint](/docs/nlweb) at `/ask`. It is separate from both MCP servers and never reads member, authenticated, or private data. ```bash curl --get "https://agentcommunity.org/ask" \ --data-urlencode "query=What is AID?" \ --data-urlencode "top_k=5" ``` ## A2A endpoint JSON-RPC A2A requests are accepted at [agentcommunity.org/a2a](https://agentcommunity.org/a2a), with discovery metadata at [/.well-known/agent-card.json](/.well-known/agent-card.json). ```bash curl -X POST https://agentcommunity.org/a2a \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":{"message":{"kind":"message","messageId":"example-1","role":"user","parts":[{"kind":"text","text":"Show community stats"}]}}}' ``` ## SDKs & CLI The umbrella CLI covers Agent Community's live public interfaces. AID is the DNS-based agent identity & discovery format — docs at [aid.agentcommunity.org](https://aid.agentcommunity.org). - [Agent Community skills](https://www.skills.sh/agentcommunity/skills) — official skills.sh listing. - [Public agent instructions](https://github.com/agentcommunity/skills/blob/main/AGENTS.md) — supported interfaces, authorization boundaries, and contribution rules. - [github.com/agentcommunity](https://github.com/agentcommunity) — source for the public interfaces and packages. ## Access Public reads and the no-write contract simulator are free and require no API key. The shared MCP `register_agent` action is the explicit exception to read-only behavior. Pre-registering a .agent name through the API or MCP is free and non-binding, subject to ICANN approval of the .agent TLD. ## Start here - Developer portal: https://agentcommunity.org/developers - Documentation index: https://agentcommunity.org/docs - Developer overview (Markdown): https://agentcommunity.org/developers.md - LLM content index: https://agentcommunity.org/llms.txt - CLI source and agent rules: https://github.com/agentcommunity/cli/blob/main/AGENTS.md - Agent Community CLI on npm: https://www.npmjs.com/package/@agentcommunity/cli - Official MCP Registry — org.agentcommunity/mcp: https://registry.modelcontextprotocol.io/v0/servers/org.agentcommunity%2Fmcp/versions/latest - Authentication and access boundaries: https://agentcommunity.org/auth.md - Privacy policy: https://agentcommunity.org/privacy - Terms: https://agentcommunity.org/terms - Contact: mailto:hello@agentcommunity.org - OpenAPI 3.1 specification: https://agentcommunity.org/openapi.json - Published content API: https://agentcommunity.org/api/v1/content - Bounded public-read batch API: https://agentcommunity.org/api/v1/batch - Agent contract simulator workbench: https://agentcommunity.org/sandbox - No-write agent contract simulator API: https://agentcommunity.org/api/v1/sandbox/simulate - NLWeb documentation answers: https://agentcommunity.org/ask - NLWeb documentation guide: https://agentcommunity.org/docs/nlweb - Product MCP endpoint: https://agentcommunity.org/mcp - Product MCP manifest: https://agentcommunity.org/.well-known/mcp - Documentation MCP endpoint: https://agentcommunity.org/mcp/docs - Documentation MCP manifest: https://agentcommunity.org/.well-known/mcp-docs.json - Documentation MCP compatibility-discovery card: https://agentcommunity.org/.well-known/mcp-docs/server-card.json - Documentation MCP guide: https://agentcommunity.org/docs/docs-mcp - A2A endpoint: https://agentcommunity.org/a2a - A2A agent card: https://agentcommunity.org/.well-known/agent-card.json - Protected Agent API resource metadata: https://agentcommunity.org/.well-known/oauth-protected-resource/api - Agent authorization server metadata: https://agentcommunity.org/.well-known/oauth-authorization-server - Agent authorization server public keys: https://agentcommunity.org/.well-known/jwks.json - Scoped own-account agent resource: https://agentcommunity.org/api/v1/agent/account - Scoped own-registration agent resource: https://agentcommunity.org/api/v1/agent/registrations ## Official packages - [@agentcommunity/mcp](https://www.npmjs.com/package/@agentcommunity/mcp) — npm cli v0.1.2; `npx -y @agentcommunity/mcp`; Official stdio connector for the hosted Agent Community MCP server - [@agentcommunity/dmv-agent](https://www.npmjs.com/package/@agentcommunity/dmv-agent) — npm cli v0.2.2; `npx -y @agentcommunity/dmv-agent`; CLI + stdio MCP server for .agent pre-registration; compatibility alias: [dmv-agent](https://www.npmjs.com/package/dmv-agent) - [@agentcommunity/aid](https://www.npmjs.com/package/@agentcommunity/aid) — npm sdk v2.1.1; `npm install @agentcommunity/aid`; TypeScript SDK for AID, DNS-based agent discovery - [aid-discovery](https://pypi.org/project/aid-discovery/) — pypi sdk v2.1.1; `pip install aid-discovery`; Python SDK for AID, DNS-based agent discovery - [github.com/agentcommunity/agent-identity-discovery/packages/aid-go/v2](https://pkg.go.dev/github.com/agentcommunity/agent-identity-discovery/packages/aid-go/v2@v2.1.1) — go sdk v2.1.1; `go get github.com/agentcommunity/agent-identity-discovery/packages/aid-go/v2@v2.1.1`; Go SDK for AID, DNS-based agent discovery - [@agentcommunity/aid-doctor](https://www.npmjs.com/package/@agentcommunity/aid-doctor) — npm cli v2.1.1; `npx -y @agentcommunity/aid-doctor`; CLI to validate AID records - [@agentcommunity/cli](https://www.npmjs.com/package/@agentcommunity/cli) — npm cli v0.1.3; `npx -y @agentcommunity/cli`; Read-only CLI for Agent Community public MCP, content, NLWeb, and batch interfaces Package roles and ownership checks: https://agentcommunity.org/docs/official-packages