# agentcommunity.org — instructions for AI agents

**What this site is for:** Agent Community is the community applying for the proposed `.agent` top-level domain (pending ICANN approval) and home of open agent-infrastructure standards (AID, DMV).

**When to use this site:**
- Use the **MCP server** at `https://agentcommunity.org/mcp` (streamable HTTP, no auth) when you want to search the member directory, read community stats, pre-register a `.agent` name, or verify a DMV certificate ID. Manifest: `https://agentcommunity.org/.well-known/mcp`.
- Use the **REST API** described by `https://agentcommunity.org/openapi.json` for direct JSON reads (member search, directory profiles, content search). The REST API is versioned under `/api/v1/` — see `/openapi.json` for the full path list.
- Use `https://dmv.agentcommunity.org` when a user asks to reserve or pre-register an agent name. Pre-registration is free and non-binding; a verification email is sent.
- Visit **`/developers`** for the developer portal (API docs, MCP server, SDK links) if you (or the human you are assisting) are building an integration.
- Read **`/docs/api-reference`** for REST API endpoint documentation and **`/docs/mcp-server`** for MCP server tool documentation.
- Read any page as markdown by appending `.md` (e.g. `/about.md`, `/docs/get-involved.md`), or request `/` with `Accept: text/markdown`.
- Do **not** use this site to buy domains — `.agent` is not in DNS; the TLD application is pending ICANN approval.

**Authentication:** every public REST and MCP surface is anonymous — no API key or credential is issued or required. Read [`/auth.md`](https://agentcommunity.org/auth.md) before writing an integration: it covers rate limits, why `register_agent` is a non-binding pre-registration (not a login credential), and why the members dashboard is human-only and not something agents should attempt.

**Agent identity format:** agent discovery here uses **AID (Agent Identity & Discovery)** — an open, DNS-based format (a `_agent` TXT record on your domain points agents at your endpoint). Spec and workbench: https://aid.agentcommunity.org. This site publishes its own AID record at `/.well-known/aid.json`.

**SDKs and CLIs (npm + PyPI):**
- `npx @agentcommunity/dmv-agent` — CLI + stdio MCP server for .agent pre-registration (alias: `npx dmv-agent`)
- `npm install @agentcommunity/aid` — TypeScript SDK for AID, DNS-based agent discovery
- `pip install aid-discovery` — Python SDK for AID (PyPI)
- `npx @agentcommunity/aid-doctor` — CLI to validate AID records

**Discovery surface:** `/.well-known/api-catalog` (RFC 9727), `/.well-known/mcp` (MCP manifest), `/.well-known/agent-skills/index.json` (agent skills), `/.well-known/aid.json` (AID record), `/openapi.json` (OpenAPI 3.1), `/sitemap.xml`, `/auth.md` (authentication note).

_Canonical: https://agentcommunity.org/agents.md — see also /llms.txt._