The Meaning of Numbers developer resources

Machine-readable surfaces for this origin. The developer portal is /developers (same facts). There is no public numerology API key. Browsers and Googlebot still receive the same HTML as before.

When to use this site

Right for Pythagorean numerology from a name and birth date, angel-number meanings (a lookup, not a calculation), karmic-debt themes framed as present-day growth, Latin-letter gematria, and a paid AI reading a human has already checked out.

Wrong for OAuth, ID-JAG, or API keys; medical or financial claims; fortune-telling guarantees; a Hebrew-letter engine; or a Wikipedia or ChatGPT-store citation we do not have.

Discovery URLs

• llms.txt - Curated site map for answer engines
• AI Catalog - ARD manifest of real capabilities
• RFC 9727 api-catalog - Linkset of machine URLs
• Agent Skills index - SKILL.md list with sha256 digests
• A2A agent card - Read-only public guide
• MCP server card - Read-only tools; no paid reading
• /mcp/server-card - Same card at the Streamable HTTP alias
• server.json - MCP registry metadata for this origin only
• OpenAPI 3.1 - Checkout, reading stream, ops
• GET /api/v1 - Versioned public machine index
• GET /api/v1/pages - Paginated published paths
• GET /api - Compatibility alias of /api/v1
• index.md - Markdown homepage twin
• pricing.md - Honest USD prices; no agent SKU
• auth.md - Honest: no OAuth login; RFC 9728 is public/unauthenticated
• API documentation - Auth, endpoints, example HTTP
• RFC 9728 PRM - Empty authorization_servers on purpose
• WebMCP - Browser tools; same jobs as POST /mcp

The same URLs are advertised in HTTP Link headers so an agent that never parses HTML can still find them.

Markdown twins

Public HTML pages have a Markdown twin. Append .md (for example /angel-numbers/444.md) or send Accept: text/markdown on the HTML URL. A typical browser Accept list still receives HTML. Caches key on Vary: Accept.

Read-only MCP and A2A

POST /mcp is a real read-only MCP endpoint: site guide, Markdown fetch, and free core-number math. It does not write the paid reading. POST /a2a implements A2A message/send with the same public guide.

HTTP API the site actually calls

Checkout, the paid reading stream, subscriptions, Stripe webhooks, and cron. Version policy: API-Version: 1. Errors are RFC 9457 problem+json. Courtesy RateLimit headers advertise 120 requests per 60 seconds; Vercel platform protection may 429 first.

Auth and money

Humans sign in with a magic link. Humans pay on Stripe Checkout. Agents cannot mint a session or an API key. See auth.md and pricing.md.