---
title: The Meaning of Numbers API documentation
url: "https://themeaningofnumbers.com/docs"
canonical: "https://themeaningofnumbers.com/docs"
---

# The Meaning of Numbers API documentation

HTTP and agent interfaces this origin actually runs. There is no public API key
and no OAuth login for agents. Start here, then fetch [openapi.json](https://themeaningofnumbers.com/openapi.json).

## Authentication

Public machine surfaces need **no token**. RFC 9728 metadata at
[/.well-known/oauth-protected-resource](https://themeaningofnumbers.com/.well-known/oauth-protected-resource)
lists this origin in `authorization_servers` so a walkthrough can fetch AS
metadata, and keeps `bearer_methods_supported` empty. Public reads need no token.

Humans sign in with a magic link at [/account/sign-in](https://themeaningofnumbers.com/account/sign-in).
Paid readings use Stripe Checkout. See [auth.md](https://themeaningofnumbers.com/auth.md).

## Endpoints

| Method | Path | Who |
|---|---|---|
| GET | /api/v1 | Anyone. Versioned JSON index. |
| GET | /api/v1/pages | Anyone. Paginated published paths. |
| GET | /api | Anyone. Compatibility alias of /api/v1. |
| POST | /api/checkout | Browser. Starts Stripe Checkout. |
| POST | /api/reading | Paid `sessionId` only. |
| POST | /mcp | Anyone. Streamable HTTP, read-only tools. |
| GET | /mcp | Anyone. SSE when Accept includes text/event-stream; otherwise the server card. |
| GET | /ask | Anyone. NLWeb-style published-path list. |
| POST | /api/v1/jobs | Anyone. Immediate markdown fetch job (202). |
| POST | /api/v1/batch | Anyone. Published-path lookups. |
| GET | /openapi.json | Anyone. |

Unknown `/api/...` paths return RFC 9457 `application/problem+json` with
`code`, `message`, and `resolution`. POST-only routes answer GET with 405.

## Example requests

```http
GET /api HTTP/1.1
Host: themmeaningofnumbers.com
Accept: application/json
```

```http
GET /api/checkout HTTP/1.1
Host: themmeaningofnumbers.com
Accept: application/json
```

That GET returns 405 problem+json (`code: method_not_allowed`). The live call is:

```http
POST /api/checkout HTTP/1.1
Host: themmeaningofnumbers.com
Content-Type: application/json

{"slug":"life-path","tier":"full","name":"Ada Example","m":12,"d":10,"y":1990}
```

Read-only Streamable HTTP MCP (JSON or `text/event-stream`):

```http
POST /mcp HTTP/1.1
Host: themmeaningofnumbers.com
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-11-25

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"example","version":"1"}}}
```

GET /mcp with `Accept: text/event-stream` is the Streamable HTTP GET stream
(200 SSE, plus `Mcp-Session-Id`). `notifications/initialized` is 202 empty.
The card is at [/mcp/server-card](https://themeaningofnumbers.com/mcp/server-card)
and [server.json](https://themeaningofnumbers.com/server.json).

## Versioning and deprecation

Public read operations are version 1 at `/api/v1`. Breaking changes will use
`/api/v2`. The optional `API-Version: 1` request header is echoed on responses.
Deprecated operations will send `Deprecation` and `Sunset` headers. None are
deprecated today. Checkout and webhook paths stay unprefixed (browser routes).
Machine copies: [https://themeaningofnumbers.com/api/v1/versioning](https://themeaningofnumbers.com/api/v1/versioning)
and [https://themeaningofnumbers.com/api/v1/errors](https://themeaningofnumbers.com/api/v1/errors).

## Pagination

`GET /api/v1/pages?page=1&per_page=20` lists published HTML paths plus their
markdown twins. `Link` headers carry `first`, `prev`, `next`, and `last`.
Maximum `per_page` is 50.

## Rate limits

Responses send IETF `RateLimit` / `RateLimit-Policy` plus `RateLimit-Limit`,
`RateLimit-Remaining`, and `RateLimit-Reset` (120 requests / 60 seconds,
courtesy). 429 includes `Retry-After`.

## More

- [for-agents](https://themeaningofnumbers.com/for-agents) - full machine map
- [pricing.md](https://themeaningofnumbers.com/pricing.md)
- [auth.md](https://themeaningofnumbers.com/auth.md)
- [llms.txt](https://themeaningofnumbers.com/llms.txt)