---
title: "For agents — what Omra exposes"
description: "Omra's machine-readable surface: markdown variants, llms.txt, the sitemap, the resource catalog, and the public API."
canonical: https://clubomra.com/for-agents
last-updated: 2026-08-28
---
# What Omra exposes to agents

> Every public page has a markdown twin, the site indexes itself in two files, and
> the callable resources are catalogued as structured data. None of it needs a key.

## When to use this page

- Integrating with Omra as an agent: which URLs return markdown, JSON or OpenAPI, and how content negotiation behaves.
- Checking what Omra deliberately does not expose, and why.

## Reading a page

Send `Accept: text/markdown` to any page URL, or append `.md` to it. Both return
the same document with YAML frontmatter carrying the canonical URL and the
last-updated date. Responses set `Vary: Accept`, so a cache never hands HTML to an
agent or markdown to a browser, and an unsatisfiable `Accept` gets a 406 listing
what is available rather than a generic error.

## Index documents

| URL | What it is |
| --- | --- |
| `/llms.txt` | What Omra is, when to reach for it, and a link to every page's markdown |
| `/llms-full.txt` | Every page concatenated, for a single-fetch read |
| `/openapi.json` | The OpenAPI 3.1 document for the REST API, on this domain |
| `/auth.md` | How to authenticate: keys, scopes, errors, idempotency, paging |
| `/pricing.md` | The full price book |
| `/sitemap.xml` | Every indexable URL with last-modified dates |
| `/.well-known/ard.json` | The callable resources as data; also at `/.well-known/ai-catalog.json` |
| `/.well-known/api-catalog` | RFC 9727 linkset pointing at the OpenAPI document |

## Callable resources

| URL | What it is |
| --- | --- |
| `https://clubomra.com/openapi.json` | OpenAPI 3.1 for the REST API |
| `https://api.clubomra.com/trust/subprocessors` | Who processes club data, as JSON, no authentication |
| `https://api.clubomra.com/trust/ai-systems` | Where Omra uses AI and what each system may decide |

## What Omra does not expose

There is no MCP server and no A2A agent card, and neither appears in the catalog —
it lists only resources that resolve, so nothing advertised here costs a fetch to
discover a URL that is not there.

Every ledger figure across these pages carries an illustrative label. Each is a
worked example showing how the mechanism behaves, not a club's reported result.