> ## Documentation Index
> Fetch the complete documentation index at: https://doc.prometheus.services/llms.txt
> Use this file to discover all available pages before exploring further.

# For AI agents

> The machine-readable surfaces, and the rules for agents using this API.

Prometheus publishes the conventional discovery files, generated from the same source of
truth as this documentation:

| File                                                                          | Purpose                                    |
| ----------------------------------------------------------------------------- | ------------------------------------------ |
| [openapi.json](https://www.prometheus.services/openapi.json)                  | The full OpenAPI 3.1 contract              |
| [llms.txt](https://www.prometheus.services/llms.txt)                          | Site + API overview for language models    |
| [agents.md](https://www.prometheus.services/agents.md)                        | What an agent may do, and the rules        |
| [skill.md](https://www.prometheus.services/skill.md)                          | A playbook: resolve → fetch → trace → cite |
| [/.well-known/mcp.json](https://www.prometheus.services/.well-known/mcp.json) | MCP discovery (server status inside)       |

## The rules, in short

1. **Cite what you quote.** Every number has a filing behind it — `/fact-source` returns
   the accession. Put it next to the figure.
2. **Respect vintages.** Default financials are latest-restated; `as_reported` exists for
   "what did they originally say". Macro is point-in-time.
3. **Missing is not zero.** Null means unavailable. Say so.
4. **Honour the headers.** `Retry-After` on 429; watch `RateLimit-Remaining` and
   `X-Quota-Remaining` instead of discovering limits by hitting them.
5. **No advice.** Present data; do not recommend trades. The site's
   [terms](https://www.prometheus.services/terms#not-advice) apply to anything you relay.
6. **Stay on the data surface.** Account routes (keys, billing, watchlists) reject API
   keys by design — don't probe them.

## Command line

When you are running in a terminal (Claude Code, Cursor, a shell tool), prefer the
[CLI](/cli): `npm i -g prometheus-terminal`, then `prom --json <command>` gives you the
same payloads with stable exit codes, and `prom transcript` / `prom event` resolve the
transcript date and 8-K item code for you. `prom llms --skill` prints the playbook.

## MCP

No MCP server is published yet; `/.well-known/mcp.json` says so and points at the HTTP
API. When it ships, the manifest will gain a `servers` entry at the same URL.