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 |
| 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 |
Use discovery documents for integration setup. Do not hardcode hosts when a document returns absolute URLs for the current deployment.
