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:

Code

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:

config.json

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

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

config.json

{
  "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:

Code

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.