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

# HTTP API

> Secondary surface — same tools and JSON over HTTP when you are not using MCP. Branded curl/SDK examples for api.geometry.app land here when that door is ready.

GEOMETRY’s **primary** surface for AI apps is **[MCP](/quickstart)** (`https://mcp.geometry.app/mcp`). Use that first.

**HTTP / REST** is the **secondary** door for apps, scripts, and pipelines that are not MCP-native. Same three tools, same JSON contracts — different transport.

## Status

| Surface      | Role                                                                  | Today                                                                                                       |
| ------------ | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **MCP**      | Connectors in Claude, ChatGPT, Cursor, VS Code, and other MCP clients | Live — [Quickstart](/quickstart)                                                                            |
| **HTTP API** | JSON over HTTP for apps and scripts                                   | Same tools as MCP; branded **`api.geometry.app`** routes and public curl examples ship in a later docs pass |

When the branded API door is ready, this page will add curl examples, auth (`?key=`), and rate-limit notes — still pointing at the same tools:

* [`get_card_for_birthdate`](/tools/get-card-for-birthdate)
* [`get_compatibility`](/tools/get-compatibility)
* [`get_day_card`](/tools/get-day-card)

## What stays the same

* Inputs (e.g. bare `YYYY-MM-DD`) and complete JSON outputs
* Coverage window and calendar rules — [When it covers](/coverage)
* Keys and rotation — [Where your key goes](/connect-and-keys)
* Payload field meaning — [What you get](/payload-shapes) · [Field glossary](/field-glossary)

## What to use now

1. Prefer **MCP** if your host supports connectors (Claude, ChatGPT, Cursor, VS Code, …).
2. If you need raw HTTP today, wait for the canonical `https://api.geometry.app/…` examples on this page — or use MCP until then.
3. Questions about zodiac or calendar disagreement belong in [Astro wheels](/astro-wheels) / [FAQ](/faq) — not “API vs MCP.”

## Next

* [Quickstart](/quickstart) — connect MCP
* [What you get](/payload-shapes) — tools and shapes
* [Support](/support) — self-serve triage