#Agent discovery
Every file below is a real static file, generated from the same source as the MCP server, so they cannot drift from the tools.
| URL | Content type | What it is |
|---|---|---|
/.well-known/mcp/server-card.json | application/json | MCP server card: server info, the Streamable HTTP endpoint, capabilities and the tool list |
/.well-known/mcp.json | application/json | Alias of the server card |
/.well-known/agent-card.json | application/json | A2A agent card with one skill per tool |
/.well-known/agent.json | application/json | Alias of the agent card |
/.well-known/api-catalog | application/linkset+json | RFC 9727 catalog linking the OpenAPI file, the MCP endpoint, the docs and llms.txt |
/openapi.json | application/json | OpenAPI 3.1 for /mcp and /api/tools/{name} |
/llms.txt | text/plain | Short site summary with links to every docs page |
/llms-full.txt | text/plain | The complete documentation in one file |
/robots.txt | text/plain | Crawl rules with a Content-Signal and explicit allows for GPTBot, ClaudeBot, Claude-User, OAI-SearchBot, Google-Extended and PerplexityBot |
/sitemap.xml | application/xml | All pages including docs |
/docs/<page>.md | text/markdown | Raw markdown of any docs page |
The home page also sends Link headers: rel="service-desc" (OpenAPI), rel="api-catalog" and rel="mcp".
#Registry metadata
server.json at the repository root describes the server for the official MCP registry under the name io.github.nirholas/papertrade-explorer, with a Streamable HTTP remote at the live /mcp. It is metadata only. Publishing it is a separate, owner-controlled step.
#Fetching docs as markdown
Add .md to any docs path:
curl -s https://papertrade-explorer.pages.dev/docs/concepts.mdView as markdown Docs for v0.2.0