GEOMETRY MCP

Deterministic temporal reference data for AI builders — calendars, seasons, moon phases, planetary retrogrades, and traditional symbolic systems as stable JSON over Model Context Protocol.

Same date → same bytes, every time. No hallucinated dates. No wallet connect. No seed phrases.

This repository is the public docs + listing face for the hosted GEOMETRY MCP server. It is not the engine source, schema, or internal design docs.

MCP URL	https://mcp.geometry.app/mcp
Docs	docs.geometry.app
Product	geometry.app
Pricing	geometry.app/pricing
Company	Goqo Labs · GitHub org goqolabs
Official Registry	app.geometry/mcp
Glama	Connector listing · namespace search

Namespaces: Glama listing id app.geometry.mcp ≠ Official MCP Registry name app.geometry/mcp. Connect URL is always https://mcp.geometry.app/mcp.

Repo layout

• docs/ — Mintlify pages (MDX, tools, llms.txt)
• docs/docs.json — Mintlify config (content root = /docs)
• logo/ — brand assets at repo root (favicon + light/dark)

Try it (no account)

Paste the branded URL into your MCP client:

https://mcp.geometry.app/mcp

Client	Auth
Claude Desktop / Claude Code	Custom connector · plain URL
ChatGPT Plugins	Server URL · Authentication = No Auth (not OAuth)
Cursor / VS Code	HTTP MCP · plain URL

Cursor / VS Code (mcp.json)

No Auth try:

{
  "mcpServers": {
    "geometry": {
      "url": "https://mcp.geometry.app/mcp"
    }
  }
}

Builders with a portal key (never commit a real zpka_):

{
  "mcpServers": {
    "geometry": {
      "url": "https://mcp.geometry.app/mcp?key=YOUR_KEY"
    }
  }
}

Install walkthroughs: geometry.app/tutorial · Quickstart.

Limits apply on the free try path — see pricing.

Builders (Free / Starter key)

For a stable sandbox quota or paid volume, subscribe in the Developer Portal, then append your key:

https://mcp.geometry.app/mcp?key=YOUR_KEY

Same tools and fields on every plan — you pay for volume, not features. Checkout is the official Zuplo Developer Portal (https://geometry-main-bf0a4d2.zuplo.site/pricing), then Stripe — Billing · Connect & keys · Pricing.

Never paste zpka_… keys into GitHub Issues or public chats.

Tools

Tool	Purpose	Docs
get_date	Resolve one civil date to stable calendars, seasons, and card identity	Date identity JSON
get_compatibility	Compare two dates across shared symbolic systems	Two-date compatibility
get_name	Map a name to cosmic cards plus ~100 Latin cipher sums	Name → cosmic cards

Coverage focus: 1900–2100. Ask examples: “What’s the birth card for 1985-03-15?” · “How compatible are 1990-05-14 and 1985-11-02?”

Support

docs.geometry.app/support · GitHub Issues (paid plans)

License

See LICENSE.

The MIT license applies to the documentation in this repository only. The GEOMETRY engine, schema, and hosted service are proprietary and are not included here.