English Français العربية

GEOMETRY

Official registry Productivity

Deterministic calendars and cosmic date JSON for AI agents via MCP (Gregorian 1900-2100).

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http geometry 'https://mcp.geometry.app/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "geometry": {
            "type": "http",
            "url": "https://mcp.geometry.app/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. GEOMETRY MCP
  2. Try it (no account)
  3. Builders (Free / Starter key)
  4. Tools
  5. Support
  6. License

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 URLhttps://mcp.geometry.app/mcp
Docsdocs.geometry.app
Productgeometry.app
Pricinggeometry.app/pricing
CompanyGoqo Labs · GitHub org goqolabs
Official Registryapp.geometry/mcp
GlamaConnector 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
ClientAuth
Claude Desktop / Claude CodeCustom connector · plain URL
ChatGPT PluginsServer URL · Authentication = No Auth (not OAuth)
Cursor / VS CodeHTTP 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

ToolPurposeDocs
get_dateResolve one civil date to stable calendars, seasons, and card identityDate identity JSON
get_compatibilityCompare two dates across shared symbolic systemsTwo-date compatibility
get_nameMap a name to cosmic cards plus ~100 Latin cipher sumsName → 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.

Frequently asked questions

What is GEOMETRY?

Deterministic calendars and cosmic date JSON for AI agents via MCP (Gregorian 1900-2100).

How do I install GEOMETRY?

It runs as a remote server. In Claude Code: claude mcp add --transport http geometry 'https://mcp.geometry.app/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does GEOMETRY need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is GEOMETRY open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains GEOMETRY?

It is published by goqolabs. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.