> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mermail.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Discovery

> Find Mermail's public agent discovery, OpenAPI, and commerce metadata URLs.

Mermail exposes public discovery routes so agents and tools can understand the service before calling protected APIs.

For interactive endpoint testing with an API key (`x-api-key`), use the [API Reference](https://docs.mermail.app/api-reference/overview.md) playground.

## Human and AI-readable indexes

| Path | Purpose |
| - | - |
| `/llms.txt` | Short AI-readable index |
| `/llms-full.txt` | Longer concatenated index |
| `/auth.md` | Agent registration and auth details |
| `/_agent-home.md` | Agent-oriented landing page |

## API metadata

| Path | Purpose |
| - | - |
| `/openapi.json` | x402 discovery OpenAPI (`GET /api` and `/api/agent/v1`) |
| `/docs/openapi.json` | Full product OpenAPI including the sold API |
| `/.well-known/api-catalog` | API catalog metadata |
| `/.well-known/oauth-authorization-server` | OAuth authorization server metadata |
| `/.well-known/oauth-protected-resource` | Protected resource metadata |
| `/.well-known/openid-configuration` | OpenID Connect metadata |
| `/.well-known/jwks.json` | JSON Web Key Set metadata |

## Commerce and agent protocols

| Path | Purpose |
| - | - |
| `/.well-known/ucp` | Universal Commerce Protocol metadata |
| `/.well-known/acp.json` | Agent Commerce Protocol metadata |
| `/.well-known/mcp/server-card.json` | MCP server card (Streamable HTTP + OAuth 2.1 and optional API key) — see [MCP](https://docs.mermail.app/ai/mcp.md) |
| `/.well-known/agent-skills/index.json` | Agent skill index — see [Skills](https://docs.mermail.app/ai/skills.md) |

> [!TIP]
>
> Use discovery documents for integration setup. Do not hardcode hosts when a document returns absolute URLs for the current deployment.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.