Account
Developer Portal · Discovery

Agent discovery files

Every machine-readable file RRM Academy publishes for agents and crawlers, with its format and what it is for. All are public and need no key.

Site indexes for AI crawlers

FileFormatPurpose
/llms.txt Markdown Site index for AI crawlers: what RRM Academy publishes and where.
/llms-full.txt Markdown Expanded single-file context for the whole site.
/connect/llms.txt Markdown Scoped index for the developer portal under /connect/.
/library/llms.txt Markdown Scoped index for the research library.
/courses/llms.txt Markdown Scoped index for the course catalog.
/faqs/llms.txt Markdown Scoped index for the FAQ hub.

Agent instructions

FileFormatPurpose
/agents.md Markdown Instructions for AI agents working with the site and its API.
/auth.md Markdown How agents authenticate: account, API key, Bearer header.
/ai-instructions.md Markdown Citation and usage guidance for AI systems quoting RRM Academy.

Protocol descriptors

FileFormatPurpose
/.well-known/agent-card.json JSON Agent card describing the site as an agent endpoint.
/.well-known/mcp.json JSON MCP discovery descriptor (apex mirror of the connector worker).
/.well-known/mcp/server-card.json JSON MCP server card: the five tools with full input schemas.
/.well-known/oauth-protected-resource JSON RFC 9728 protected-resource metadata for OAuth sign-in.
/.well-known/api-catalog Linkset JSON RFC 9727 catalog pointing at every API surface.
/openapi.json OpenAPI 3.1 JSON Machine-readable API spec for client generators and tooling.

Content feeds

FileFormatPurpose
/library-feed.jsonl JSON Lines Structured feed of every published library article.
/library/rss.xml RSS 2.0 New library articles.
/commentary/rss.xml RSS 2.0 New commentary posts.

Sitemaps

FileFormatPurpose
/sitemap-index.xml XML Index of every sitemap for the site.
/schemamap.xml XML Index of corpus-wide JSON-LD schema endpoints.

Markdown for many pages

Many pages serve a Markdown version, so an agent can read the content without parsing HTML. There are two ways to get it:

  • Markdown twin: add .md to the page path on the pages that serve one. Library papers: /library/<slug>.md. FAQs: /faqs/<slug>.md. Commentary: /commentary/<slug>.md. Pillar guides: /<slug>.md. Developer portal pages: /connect/<page>/index.md, with the hub at /connect/index.md. The glossary: /glossary.md.
  • Content negotiation: request the normal page URL with Accept: text/markdown and the server returns the markdown version for the same pages.
# the twin
curl https://rrmacademy.org/connect/auth/index.md

# the same page by content negotiation
curl -H 'Accept: text/markdown' https://rrmacademy.org/connect/auth/

The canonical HTML URL for a twin is given in its Link header and footer.

Related developer pages