
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.
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(/* ... */);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 10+ endpoints as callable tools. Zero configuration.
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.
{
"id": "chariot",
"name": "The Chariot",
"arcana": "major",
"number": 7,
"keywords": {
"upright": [
"willpower",
"determination",
"victory",
"control",
"focus"
],
"reversed": [
"lost direction",
"opposition",
"scattered will",
"forcing outcomes"
]
},
"upright": {
"keywords": [
"willpower",
"determination",
"victory",
"control",
"focus"
],
"description": "The Chariot is the card of directed will, the force that carries a resolve into the world. In the Rider-Waite-Smith image an erect and princely figure stands in a chariot beneath a canopy of stars, a drawn sword in hand, crescent moons on the shoulders and a square upon the breast. Two sphinxes, one black and one white, are harnessed before him, pulling toward opposing aims, and the charioteer holds them to a single course not by reins but by the strength of his command. Waite called him conquest on all planes, triumph above all in the mind, the one who has led captivity captive.\n\nIn a reading, The Chariot marks a time to take focused action and hold a chosen course. A decision has been made, often building on the values weighed under The Lovers, and now the work is to drive it forward with discipline and conviction. The card favours assertion over passivity, momentum over hesitation. Where there is a goal worth reaching, it promises success to the one who keeps focus and does not waver.\n\nIt also speaks of mastering opposing forces. The two sphinxes are the competing pulls within and around the charioteer, ambition against fear, one desire against another, and victory depends on holding them to one direction rather than letting them tear the course apart. Control here is inner before it is outer, the harnessing of one own divided energies toward a single aim.\n\nThe deeper instruction of The Chariot is that triumph is earned by will, not granted by circumstance. There will be obstacles and competing distractions, and the card asks for boundaries held firm and effort sustained past the point of ease. To know what is wanted, to drive toward it with discipline, and to keep command of oneself amid the pull of opposing forces, is the lesson and the victory.",
"love": "Determination and clear intent move matters of the heart forward. For those pursuing a connection, confidence and a sense of direction draw success. Within a partnership, two people aligning their effort toward a shared aim deepens the bond. The card favours acting with purpose rather than waiting for circumstance to decide.",
"career": "Forward momentum, achievement, and hard-won victory define the professional path now. Obstacles yield to sustained effort and disciplined focus, and recognition or advancement may follow. The card rewards the one who sets a clear target and drives toward it without losing command of the course along the way.",
"finances": "Steady progress through discipline and focus is indicated. Control over the financial picture grows as effort is directed toward a defined goal rather than scattered. The card favours the determined, deliberate push toward security, and rewards the focus that holds a plan together against distraction.",
"health": "Strong will supports the pursuit of health goals, and the determination is present to push through limitation and see a regimen through. Disciplined, focused effort serves well now, and active, demanding pursuits suit the energy. The card favours channelling drive toward a clear physical aim while keeping command of its intensity.",
"spirituality": "The work now is to master the balance between spiritual and material drives, holding opposing pulls to a single direction. Discipline and focused will advance the practice. The card invites directing that inner force toward mastery of the ego rather than letting competing desires scatter the path."
},
"reversed": {
"keywords": [
"lost direction",
"opposition",
"scattered will",
"forcing outcomes"
],
"description": "Reversed, The Chariot describes a will that has lost its course. The drive may have drained away, leaving a project pushed forward out of habit rather than conviction, or the two sphinxes may have broken loose, pulling in opposite directions until forward motion stalls. Effort is being spent without traction. The card asks whether the goal still holds meaning, and whether the wiser move is to change direction rather than batter on against a wall.\n\nThe reversal can also mark obstacles that have begun to win, the sense that it has all become too hard and the resolve to continue has thinned. Here the remedy is to return to first reasons: why the aim was chosen, what it is worth, and whether the commitment will outlast the discomfort. Outside opinion and early setbacks test the course now, and the question is whether to be swayed by them or to hold.\n\nA subtler form of the reversal turns the energy inward before action. The work shifts to self-discipline, inner alignment, and the quiet preparation that readies a person to move well when the time comes. Equally, the card warns against the opposite fault: gripping every detail so tightly that control itself becomes the problem. To loosen the hold and let some things run their course is as much a part of mastery as the drive to command. The lesson is to direct the will, not force it.",
"love": "Control issues, force, or a loss of direction are unsettling the romantic life. A bond may be pushed too hard, or a partner held away by a domineering grip. The reversal asks for the need to control outcomes to be released, and for honest reflection on whether the course still serves both people involved.",
"career": "Direction has been lost, motivation has thinned, or obstacles feel insurmountable, and effort may be aimed at goals that no longer fit. The reversed card counsels a pause to reassess the professional course and rediscover the genuine drive beneath it, rather than forcing momentum that has gone hollow.",
"finances": "Financial goals are stalling for want of focus or a sound plan, and aggressive moves risk backfiring. The reversal counsels slowing down, reassessing the strategy, and regaining real control before pressing forward again. Force applied without direction tends to cost more than patience would.",
"health": "Burnout or strain from pushing the body too hard may be taking a toll, and frustration can be feeding the problem. The reversed card asks for drive to be balanced with rest, and for the wisdom to pull back rather than override the body signals in pursuit of a goal.",
"spirituality": "Will is being used to force spiritual progress or to bypass the slower work of emotional healing. Growth of this kind cannot be driven into existence. The reversal asks for patience, surrender, and trust alongside discipline, letting the path unfold rather than commanding it forward."
},
"imageUrl": "https://roxyapi.com/img/tarot/major/chariot.jpg"
}Structured JSON with documented fields. Not hallucinated text. See all 10+ endpoints
Works with your stack
Production-ready tarot card reading API + hosted MCP for AI agents and developers. Connect Claude Code, Cursor, VS Code in seconds, no local setup. Complete 78-card Rider-Waite-Smith deck with domain-specific interpretations for love, career, health, and spiritual growth. Celtic Cross, three-card, love, career, yes/no oracle, daily card, and custom spreads. Seeded reproducibility for personalized daily readings. Card images included. 10+ endpoints optimized for tarot apps, AI tarot chatbots, fortune-telling platforms, and spiritual wellness products.
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
AI-optimized JSON responses with structured card data, spread positions, and contextual interpretations, perfect for MCP-powered tarot chatbots and LLM integration
Multi-language responses in 8 languages (EN, TR, DE, ES, HI, PT, FR, RU) via ?lang= query parameter
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.

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.
Every page here is built so AI search engines can read and cite it, so go straight to the source. 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.
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, and PHP, 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. 10+ endpoints, MCP server, SDK, and starters.
Plans from $39/mo — thats $3.25 per domain. 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.