GemZen Now Speaks MCP: Oracle Tools for Chatbots, Voice Agents and AI Companions
Any AI agent can now draw a tarot card, cast a birth chart or check the moon through GemZen — via the Model Context Protocol or plain REST. Here is what we built, what it can do, and how to get a free developer key.

Something quietly big shipped at GemZen: our oracle engine is now open to other apps.
If you are building a chatbot, a voice agent, a game NPC or a 3D AI companion, your creation can now do what GemZen does — draw a real tarot card, cast an accurate birth chart, read the runes, check tonight's actual moon — with one API call. No astrology library to integrate, no card database to license, no ephemeris math to get wrong.
What is MCP, and why it matters
The Model Context Protocol (MCP) is the open standard AI assistants use to reach outside tools — the same protocol behind connectors in Claude and ChatGPT, and natively supported by the platforms most voice and avatar apps are built on today: Vapi, ElevenLabs Agents, LiveKit, Pipecat, the OpenAI Realtime API, Inworld and more.
GemZen now serves MCP directly. Point any of those platforms at our endpoint, and every GemZen tool appears in your agent's hands automatically — described, typed, and ready to call. If your stack does not speak MCP, the same tools are mirrored as plain REST endpoints with published schemas.
Seventeen tools, three flavors
Reference content. The full meaning of any of the 78 tarot cards, 24 Elder Futhark runes, 64 I Ching hexagrams, 36 Lenormand cards, crystals, chakras and moon phases — the same curated interpretations GemZen members read every day.
Real computation. A complete natal chart — planets, houses, aspects, Ascendant — computed by a real ephemeris in about five milliseconds. Synastry with a compatibility score. The sky right now, including retrogrades and the moon's true phase and sign. Numerology profiles. Biorhythms.
Daily experience. A card of the day that is deterministic per user — ask twice, get the same card; ask tomorrow, get a new one. A composed daily guidance snapshot that blends the real moon phase, the day's numerology and the daily card, with zero latency cost.
And for partners on paid plans, one more: full AI-written oracle readings, where your user asks a question, we draw the spread and interpret it, and your agent speaks the answer.
What this looks like in practice
- A VTuber's AI co-host pulls the audience's card of the day live on stream
- A voice companion answers "is Mercury actually in retrograde right now?" with the real answer
- A dating app's assistant runs genuine synastry between two birth charts, not a sun-sign lookup table
- A meditation app's guide opens each session with the moon's true phase and what it invites
- Claude or ChatGPT users connect GemZen and bring their practice into their assistant
Built to be trusted
Every response carries its content version, an attribution line, and the same grounding we hold ourselves to: readings are for reflection and entertainment — never medical, legal or financial advice. Partners agree to pass that framing through to their users. The occasional wrong answer from an improvising language model is exactly what this replaces: when your agent calls GemZen, the chart math is real, the card meanings are consistent, and the moon is where we say it is.
Get a key
The developer tier is free: 500 calls a day, every content and computation tool included. The full documentation — quickstart, tool reference, plans — lives at gemzen.app/developers, and a key is one contact form away, usually issued the same day.
We built GemZen to help people see themselves more clearly. Now your agents can borrow its eyes.

