
AI Astrology Chatbot
Web App / Open Source30 minAI chatbot with real readings across all spiritual domains. Not hallucinations.
Launch a tarot reading app with 78-card authenticity. In days.
Daily CardThree Card SpreadCeltic CrossYes or No TarotLove SpreadTarot Cards …and so much more
Want to try without writing code? Try this domain live in API playground →
npm install @roxyapi/sdkimport { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.tarot.get(/* ... */)pip install roxy-sdkfrom roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
result = roxy.tarot.get(...) # async: await roxy.tarot.get_async(...)composer require roxyapi/sdkuse function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->tarot->get(/* ... */);dotnet add package RoxyApi.Sdkusing RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
// await roxy.Tarot.<resource>.GetAsync() or .PostAsync(new() { ... })go get github.com/RoxyAPI/sdk-goimport roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
// resp, err := roxy.Tarot.<Method>(context.Background(), nil)curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/tarot/claude mcp add --transport http \
roxy-tarot https://roxyapi.com/mcp/tarot \
--header "X-API-Key: YOUR_KEY"AI agents auto-discover all endpoints as callable tools. Zero configuration. Responses can come back token-optimized and lossless, cutting the tokens your agent spends per call by roughly 40 to 52 percent.
Want to ship faster? Clone a free template and go from zero to production in 30 minutes.
Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app in minutes.
Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.
{
"spread": "Celtic Cross",
"question": "What should I know about this situation?",
"positions": [
{
"position": 1,
"name": "Present Situation",
"interpretation": "Represents what is happening to you at the present time. Reflects your state of mind and how you may be perceiving the situation. This is the heart of the matter, central to your life right now.",
"card": {
"id": "star",
"name": "The Star",
"arcana": "major",
"number": 17,
"position": 1,
"reversed": true,
"keywords": [
"lost faith",
"despair",
"discouragement",
"disconnection"
],
"meaning": "Reversed, The Star describes hope dimmed and faith hard to find. Overwhelmed by challenge, a person may be questioning why the difficulty has come and struggling to sense any support or meaning in it. The water of life that flowed so freely upright seems to have run dry. Yet the card insists the source has not vanished, only become hard to perceive, and the work is to look harder and to reframe the trial as something to learn from rather than a punishment.\n\nOften the reversal is a test of faith. Confronted with hardship, a person can collapse under it or stand firm in the conviction that there is still light beyond the present dark. The deeper lesson is to learn trust, not only in something greater but in oneself, and to let confidence and self-belief become the vessel through which inspiration flows again.\n\nThe reversed card frequently marks disengagement, a loss of inspiration in work, projects, relationships, or direction. What began with vision has worn down into grey routine, and the way back is to reconnect with what truly matters and realign daily life with it. The Star reversed also calls plainly for self-care. Energy reserves may be genuinely depleted, and rather than pushing harder, the card urges rest, restoration, and a return to the practices that nourish. Tending to yourself with patience refills the well, and hope, never truly gone, is allowed to return.",
"love": "Lost hope or shaken faith in love may be weighing on you, with past hurt making it hard to open again. Discouragement has dimmed the willingness to trust. The card asks you to reconnect with self-love first and to replenish before reaching outward. Hope in love is not gone, only depleted, and tending gently to yourself allows it to return.",
"career": "A loss of inspiration, a creative block, or disconnection from professional purpose marks this time. The spark that once drove the work feels dim, and routine has worn it down. The reversal asks you to reconnect with what first inspired you and to rest where you are depleted. Reigniting that sense of meaning, rather than forcing output, restores the flow.",
"finances": "Financial pessimism or a loss of faith in your ability to prosper has set in, often after a setback that shook your confidence. Discouragement makes the situation feel more fixed than it is. The card counsels rebuilding hope one small, positive step at a time. Replenish belief gradually, and let renewed confidence guide steadier financial choices.",
"health": "Hope around a health matter may be fading, with depletion, fatigue, or low spirits affecting the body. The well has run low and pushing harder will not refill it. The reversal asks for support, rest, and a deliberate reconnection with what restores you. Seek help where it is needed, and let gentle replenishment return both energy and hope.",
"spirituality": "A crisis of faith or a sense of disconnection from the source may be present, a depletion of the inner light that once guided you. Discouragement has clouded the path. The card asks for gentle attention rather than force: return to the practices that once brought peace, replenish slowly, and let the connection, never truly severed, be restored.",
"imageUrl": "https://roxyapi.com/img/tarot/major/star.jpg"
}
},
{
"position": 2,
"name": "Challenge",
"interpretation": "The immediate challenge or problem facing you. This is the one thing that, if resolved, would make life easier. Even positive cards here represent a challenge requiring attention and action.",
"card": {
"id": "four-of-swords",
"name": "Four of Swords",
"arcana": "minor",
"suit": "swords",
"number": 4,
"position": 2,
"reversed": true,
"keywords": [
"exhaustion",
"burnout",
"restlessness",
"avoided rest"
],
"meaning": "Reversed, the Four of Swords sounds an urgent call for the rest that is being refused. The reserves are running low, perhaps already on empty, drained by long hours, by carrying others, or by a demanding and stressful undertaking that has gone on too long. The reversal warns that continuing to push leads to collapse, the burnout that renders a person ineffective and unable to help anyone, least of all themselves. The rest the upright card recommends has become not optional but necessary.\n\nOften the body asks for stillness while the mind refuses to grant it. There is a restlessness, a drive to do everything at once, that overrides the signals of fatigue and pushes through a long list of tasks until wellbeing pays the price. The remedy is plain and difficult: stop. Withdraw from the clamour, take the retreat, the quiet weekend, the daily pause for the mind to settle, and let the reserves refill before they are gone entirely.\n\nThe reversal can also mark a stagnation that masquerades as recovery, time spent withdrawn that has stopped restoring and started to stall. Where rest has tipped into avoidance, the counsel is to re-emerge gently, integrating the calm solitude has given rather than hiding within it. Even a brief, genuine pause re-balances the energy, but the pause must be real. Force the rest the situation has refused, and let recovery, not endurance, become the priority.",
"love": "Exhaustion is straining matters of the heart, or a needed pause from romance is being refused. The reversed Four of Swords warns that pushing on while depleted leaves nothing to give a partner or a new connection. Step back and restore yourself before re-entering the world of love. Re-engage slowly once rested, rather than forcing closeness from an empty reserve.",
"career": "Burnout looms, and the rest the work demands is being avoided. The reversed Four of Swords warns that long hours and unrelenting pressure are draining you toward collapse. A restless drive to do everything at once overrides the clear need to stop. Force the break now, withdraw from the noise, and refill the reserves before exhaustion makes you ineffective at the work entirely.",
"finances": "Depletion is clouding financial judgement, or a needed pause from money pressure is being denied. The reversed Four of Swords cautions against acting while exhausted, when restlessness pushes for decisions the situation does not require. Step back, let the picture settle, and resist forcing financial moves from a drained state. Recovery first, then clear-headed action, protects resources better than strained effort.",
"health": "Exhaustion has reached a point that demands attention, and rest is being refused at real cost. The reversed Four of Swords warns that ignoring the body signals leads to collapse. Restlessness drives activity that fatigue cannot sustain. Stop, withdraw, and let genuine recovery take priority over the long list of tasks, before depletion forces a far longer and harder convalescence.",
"spirituality": "Spiritual reserves are running dry, or a withdrawal has stalled into stagnation. The reversed Four of Swords warns against pushing the mind onward when it plainly needs stillness, and equally against hiding in solitude past its restorative point. Take the real retreat the situation requires, quiet the restless drive, and let calm re-gather before re-emerging into active practice with renewed clarity.",
"imageUrl": "https://roxyapi.com/img/tarot/minor/four-of-swords.jpg"
}
}
],
"summary": "The Celtic Cross provides deep insight into your situation, revealing past influences, present challenges, and future possibilities."
}Structured JSON with documented fields. Not hallucinated text. See all endpoints
Render Tarot responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Tarot calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.
Tarot catalog widget snippet
Tarot spread widget snippet
The complete UI libraryExplore Roxy UI| Element | Renders |
|---|---|
| <roxy-tarot-card> | Single card with upright and reversed flip |
| <roxy-tarot-catalog> | Deck gallery tiles with card art, name, and arcana and suit |
| <roxy-tarot-spread> | Spreads with positions and reading |
Works with your stack
Tarot reading API with the complete 78-card Rider-Waite-Smith deck and card meanings for love, career, health, and spiritual growth. Celtic Cross, three-card, love, career, yes/no oracle, daily card, and custom spreads, each with upright and reversed interpretations. Seeded reproducibility for personalized daily readings, and card images included. Built for tarot apps, AI tarot chatbots, fortune-telling platforms, and spiritual wellness products. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.
Every Tarot calculation is covered by 5,960 automated tests per deploy, 828 of them gold-standard tests locked to named external references such as NASA JPL Horizons, with a public MIT benchmark repo anyone can clone and re-run. See how we test.
Multi-language API responses
Everything you need from our Tarot API, built for production:
Complete 78-card Rider-Waite-Smith deck: 22 Major Arcana + 56 Minor Arcana with upright and reversed meanings, domain interpretations (love, career, health, spiritual), and rich symbolism
Traditional spreads: Three-Card (past/present/future), Celtic Cross (10-card), Love (5-card relationship), Career (7-card SWOT), plus custom spread builder (1-10 positions)
Yes/No oracle readings with Major Arcana weighted answers (Yes, No, Maybe) and detailed reasoning for quick decision-making features in apps and chatbots
Daily tarot card with seeded reproducibility, date-based consistency for personalized daily readings, and share-friendly deterministic draws
High-quality Rider-Waite card images (345x480px JPEG) served via CDN with card descriptions, keywords, and imagery metadata for professional tarot app UIs
Click any endpoint to view detailed documentation, parameters, and response examples.
Clone. Edit. Ship. Free and open source by Team Roxy.

AI chatbot with real readings across all spiritual domains. Not hallucinations.

The practitioner website you own. Free birth charts, tarot, and human design built in.

Talk to the stars. Real readings across every spiritual domain, spoken aloud.

Full 78-card Rider-Waite deck. Every spread. Every position.
Browse all templates or use AI prompts to generate a custom app.
Real-world applications and use cases for integrating Tarot API into your projects:
Build tarot reading apps with authentic Rider-Waite-Smith interpretations: upright and reversed meanings for all 78 cards with domain-specific guidance for love, career, health, and spiritual growth
Add daily tarot features to wellness and self-discovery platforms: date-based seeded draws ensure consistent personalized cards each day with shareable results
Build AI tarot chatbots with MCP: your OpenAI, Claude, or Gemini agent auto-discovers tarot endpoints and delivers conversational readings with zero integration code
Power career and life coaching platforms with Celtic Cross (10-card), SWOT career spreads, and yes/no oracle readings for decision-making and guidance features
Create relationship and dating app features with love spreads analyzing emotional dynamics, compatibility, challenges, and partnership potential
Ship fortune-telling and divination platforms combining tarot with astrology, numerology, dreams, and I-Ching for comprehensive spiritual guidance under one API key
Dhani M.
Indie App Developer
Shipped an astrology app over a long weekend. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they line up with my reference. One API key for all of it.
Tom H.
Senior Developer
The OpenAPI spec is the most complete I have seen in this space. Generated a type-safe TypeScript client from it in seconds. Every field has descriptions and examples. Production-grade documentation.
Chris W.
Backend Engineer
Response times consistently under 50ms for numerology and tarot endpoints. The API returns structured JSON with every field documented. Integrated it into our platform in an afternoon.
The receipts are public: the testing methodology, the open MIT benchmark, the transparency report, and the live API playground. Let ChatGPT, Perplexity, or Claude search the web and tell you what they find about RoxyAPI accuracy, MCP, SDKs, and pricing.
Opens a live web search in a new tab.
From zero to production in 3 steps. No signup required for testing.
| 1Install the SDK | npm i @roxyapi/sdk |
| 2Get your API key | View Plans |
| 3Make your first call | View Docs |
Remote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 12 spiritual domains under one key.
Your agent grounds every answer in verified calculations and replies in your own voice, so it never hallucinates a chart, date, or reading. No local setup, no AGPL, no hosted-AI markup.
Audit it yourself: every Tarot endpoint runs live in the API playground
Ship a complete reading experience without building a deck or writing card meanings yourself. The tarot API draws from the full 78-card Rider-Waite-Smith deck and returns the drawn cards with their upright or reversed meanings, life-area guidance, keywords, and card imagery, ready to render. Activation is instant, and the same key unlocks all 12 RoxyAPI domains, so you can layer astrology, numerology, or dreams alongside tarot under one flat subscription. Reach for it through the typed SDKs for TypeScript, Python, PHP, C#, and Go, our drop-in UI components, the WordPress plugin, or our Remote MCP server.
Every spread your readers expect comes ready to use: three-card for past, present, and future, the ten-card Celtic Cross, a love spread for relationship dynamics, and a career spread. Each spread returns its cards already placed and interpreted position by position, plus an overall reading. When you need something proprietary, the custom spread builder lets you define your own positions from one to ten, so coaches and practitioners can offer signature layouts no other app has.
The Celtic Cross is the full ten-position professional reading, delivered in a single call. You get a drawn card for every position from the present situation and the challenge through hopes and fears to the final outcome, each with its own interpretation, plus a summary that ties the whole spread together. Pass a question to focus the reading and an optional seed to make a given reading reproducible, ideal for shareable results or saved sessions. It is available through the typed SDKs and our Remote MCP server, so an AI agent can deliver a complete Celtic Cross in conversation with no local setup.
Daily tarot is the feature that brings people back, and you can ship it without storing any reading data. Tie each draw to a date and an identifier such as a user id, and every reader sees one consistent card for the day, every time they open the app. The card arrives with its upright or reversed meaning, keywords, imagery, and a message written for the day. Translations are available in 8 languages, currently AI generated and under editorial review, so a global audience reads in their own tongue from day one.
Yes. Ask a question and get a clear Yes, No, or Maybe with a strength rating and the card behind the answer, perfect for a quick decision feature or a playful chatbot reply. The reading follows traditional practice: upright cards lean toward yes, reversed toward no, and a few naturally ambiguous cards resolve to maybe. Add an optional seed when you want the same question to return a stable answer. It is one of the fastest features to ship, and through our Remote MCP server an AI assistant can answer in plain conversation.
Every one of the 78 cards carries distinct upright and reversed interpretations, written editorially so a reversal shifts the message rather than simply negating it. Each meaning extends across five life areas: love, career, finances, health, and spirituality, giving your readings real depth instead of a single line. You control whether reversals appear, and each card tells you its orientation so you render the right artwork and text. The same editorial quality flows through the typed SDKs, our UI components, and our Remote MCP server.
Launch a tarot reading app with 78-card authenticity. In days.
All 12 domains included with every plan. Every endpoint, MCP server, SDK, and starters.
Plans from $39/mo, starting at $2.70 per domain on annual billing. No credit card required for testing.
View Pricing & Get API KeyHi, I'm Rosie, your guide to RoxyAPI's insight tools.
Ask me to read your birth chart, pull a card, or map your numbers, and I'll interpret what it means for you. Unlike most AIs, I never make the numbers up: every reading runs on real, verified calculations. Curious about the API, pricing, or docs instead? Ask me that too.