> ## 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.

## 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`                           | Public OpenAPI document               |
| `/docs/openapi.json`                      | Same OpenAPI document under docs path |
| `/.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                      |
| `/.well-known/agent-skills/index.json` | Agent skill index                    |

<Tip>
  Use discovery documents for integration setup. Do not hardcode hosts when a document returns absolute URLs for the current deployment.
</Tip>