# Agent Community — API, MCP & A2A Index

> REST, MCP, and A2A surface for agentcommunity.org: exact member lookup, community stats, agent registration, and certificate verification.

## For AI agents

**What this is:** the API, MCP, and A2A surface index for Agent Community (agentcommunity.org) — callable endpoints and the discovery catalogs that describe them.

- Use the **MCP server** at `https://agentcommunity.org/mcp` (streamable HTTP, no auth) for exact `lookup_member`, community stats, `.agent` pre-registration, or certificate verification.
- Use the separate **Documentation MCP** at `https://agentcommunity.org/mcp/docs` (streamable HTTP, no auth, read-only) for `search_docs` and `get_doc` over published documentation only — it is not part of the four-tool product MCP above. Manifest: `https://agentcommunity.org/.well-known/mcp-docs.json`. Compatibility-discovery card: `https://agentcommunity.org/.well-known/mcp-docs/server-card.json`.
- Use `https://agentcommunity.org/ask` for deterministic answers from published documentation. Canonical input is `query`; `q` is a PAGE compatibility alias, not an NLWeb v0.55 field. Send exactly one, trimmed to 2–500 characters.
- Use the **A2A endpoint** at `https://agentcommunity.org/a2a` (JSON-RPC, no auth) for the supported MCP tools. Read `/.well-known/agent-card.json` first; streaming and push notifications are not supported.
- Public MCP and A2A are not a human-account or OAuth/OTP automation interface. Send a human to `https://agentcommunity.org/join`; call `register_agent` only after explicit current-turn authorization.
- Use the **REST API** described by `https://agentcommunity.org/openapi.json` only for supported direct JSON reads. Directory search/profile/member feeds and `/api/map/search` are not machine integrations.
**Bounded public-read batch:** POST `https://agentcommunity.org/api/v1/batch` accepts at most 10 ordered `content.list` and `docs.ask` operations in a 262144-byte JSON body. The anonymous trusted-IP policy allows 10 requests per 60 seconds. The 10-second execution deadline begins when validated execution starts; no later operation starts after it, while work already running may finish.

```json
{
  "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
      }
    }
  ]
}
```
**No-write contract simulator:** the workbench at `https://agentcommunity.org/sandbox` documents and runs four deterministic parser fixtures through POST `https://agentcommunity.org/api/v1/sandbox/simulate`. It uses production response schemas with fixed synthetic values and performs no production reads, authorization, signing, or writes.
- `agent_auth_challenge` — Synthetic service authorization challenge; models POST /agent/identity with HTTP 200.
- `agent_auth_pending` — Synthetic authorization-pending OAuth response; models POST /oauth2/token with HTTP 400.
- `agent_auth_success` — Synthetic approved agent authorization response; models POST /oauth2/token with HTTP 200.
- `batch_mixed_result` — Synthetic mixed public-read batch response; models POST /api/v1/batch with HTTP 200.

```json
{
  "scenario": "agent_auth_challenge"
}
```
- Public MCP, Documentation MCP, A2A, and public-read REST endpoints remain anonymous. Own-account REST endpoints under `/api/v1/agent/*` require a scoped Bearer access token; discover the protected resource at `/.well-known/oauth-protected-resource/api` and read [`/auth.md`](https://agentcommunity.org/auth.md) before using `service_auth`.
- User-claimed `auth` commands are available for the two scoped own-account reads after public authorization discovery and the documented `service_auth` flow.

**Supported MCP and A2A tools (exactly four):**
- `lookup_member` — exact display-name or slug lookup; minimal public result only, never free-text or bulk search.
- `get_community_stats` — roughly-live member count, cached for up to 20 minutes.
- `register_agent` — explicitly authorized, free and non-binding `.agent` pre-registration.
- `verify_certificate` — live issued/not-found DMV certificate verification through the rate-limited DMV Worker.

- For the full site index (pages, docs, blog, work streams, events) see [`/llms.txt`](https://agentcommunity.org/llms.txt). For docs see [`/docs/llms.txt`](https://agentcommunity.org/docs/llms.txt).

## Endpoints

- [MCP server](https://agentcommunity.org/mcp): Streamable-HTTP MCP server (JSON-RPC 2.0, anonymous, no auth). Use exact lookup_member, community stats, registration, and certificate verification.
- [MCP manifest](https://agentcommunity.org/.well-known/mcp): MCP manifest mirroring the live /mcp endpoint (also served at /.well-known/mcp.json).
- [Documentation MCP server](https://agentcommunity.org/mcp/docs): Separate anonymous read-only documentation MCP (streamable HTTP, JSON-RPC 2.0). Exactly search_docs and get_doc over published documentation only — not part of the four-tool product MCP.
- [Documentation MCP manifest](https://agentcommunity.org/.well-known/mcp-docs.json): Manifest mirroring the live /mcp/docs endpoint.
- [Documentation MCP compatibility-discovery card](https://agentcommunity.org/.well-known/mcp-docs/server-card.json): Agent Community compatibility-discovery card for the separate read-only documentation MCP; not a claim of a ratified MCP Server Card location.
- [NLWeb documentation answers](https://agentcommunity.org/ask): GET or POST deterministic public-documentation answers. Canonical input is query; q is a PAGE compatibility alias, not an NLWeb v0.55 field.
- [A2A endpoint](https://agentcommunity.org/a2a): A2A protocol 0.3.0 JSON-RPC endpoint wrapping the supported MCP tools. Anonymous; no streaming or push notifications.
- [A2A agent card](https://agentcommunity.org/.well-known/agent-card.json): Machine-readable A2A capabilities, skills, input modes, and endpoint URL.
- [Homepage markdown alias](https://agentcommunity.org/index.md): Explicit text/markdown representation of the homepage for agents and scanners.
- [OpenAPI 3.1 spec](https://agentcommunity.org/openapi.json): Full REST API spec. Versioned endpoints live under /api/v1/.
- [REST API — globe data](https://agentcommunity.org/api/v1/globe): GET. Aggregate geographic member data.
- [REST API — paginated public content](https://agentcommunity.org/api/v1/content): GET with optional q, type, limit, and cursor. Pages over published docs, blog posts, and public pages only.
- [REST API — content search](https://agentcommunity.org/api/v1/content-search): GET, query param q. Search blog + docs content.
- [REST API — bounded public-read batch](https://agentcommunity.org/api/v1/batch): POST JSON. At most 10 ordered content.list and docs.ask operations; 262144-byte body cap and 10 requests per 60 seconds.
- [Agent contract simulator workbench](https://agentcommunity.org/sandbox): Human- and agent-readable documentation for four deterministic no-write response fixtures.
- [REST API — no-write agent contract simulator](https://agentcommunity.org/api/v1/sandbox/simulate): POST JSON. Exactly four fixed scenarios from the shared registry; 30 requests per 60 seconds.
- [RFC 9727 API catalog](https://agentcommunity.org/.well-known/api-catalog): Linkset of discoverable API endpoints.
- [ARD catalog](https://agentcommunity.org/.well-known/ai-catalog.json): Agentic Resource Discovery catalog: MCP server, OpenAPI spec, agent skills, agent docs.
- [AID v2 fallback record](https://agentcommunity.org/.well-known/agent): JSON fallback mirroring this domain's AID v2 TXT record.
- [Authentication note](https://agentcommunity.org/auth.md): Public MCP, Documentation MCP, A2A, and public-read REST endpoints remain anonymous. Own-account REST endpoints under `/api/v1/agent/*` require a scoped Bearer access token; discover the protected resource at `/.well-known/oauth-protected-resource/api` and read [`/auth.md`](https://agentcommunity.org/auth.md) before using `service_auth`.

## Capability links

- https://agentcommunity.org/.well-known/mcp.json
- https://agentcommunity.org/.well-known/oauth-protected-resource/api
- https://agentcommunity.org/.well-known/oauth-authorization-server
- https://agentcommunity.org/.well-known/jwks.json
- https://agentcommunity.org/api/v1/agent/account
- https://agentcommunity.org/api/v1/agent/registrations