# TarotAPI MCP for AI Agents AI Agent Connect > TarotAPI lets your AI agent draw cards, interpret meanings, and perform complex spreads from a full 78-card tarot deck. It handles both upright and reversed positions, giving you instant access to keywords and fortune-telling guidance. ## Overview - **Category:** artificial-intelligence - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_2aMho9ZdDvIpegGYkrIzjb00rWFMVBEZY193Df2T/ai-agent-connect - **Tags:** tarot, fortune-telling, card-meanings, random-generation, esoteric-data ## Description TarotAPI connects your AI agent to a full 78-card tarot deck. It lets you pull cards for daily guidance, explore the entire Major and Minor Arcana, and get deep meanings for both upright and reversed positions. If you're looking for a specific vibe, the agent can search the deck by keywords or meanings to find exactly what you need. It handles all the heavy lifting of card classifications and imagery, so you can focus on the interpretation. This is one of the many tools you can find in the Vinkius catalog to make your AI more capable. You don't need to worry about manual lookups or memorizing card IDs; your agent just knows the deck inside out. ## Tools ### get_api_info Get general information about the TarotAPI service. This helps you understand the scope of the deck. ### get_card Get full meanings, keywords, and imagery for a specific card. Use short names like 'ar01' for quick lookups. ### get_random_card Pull a single random card for a quick daily reading. It is perfect for when you need guidance without a specific card in mind. ### get_multiple_random_cards Draw multiple random cards at once for complex spreads. This works for three-card past, present, and future layouts. ### search_cards Find specific cards by searching their meanings or keywords. It returns all cards that match your search criteria. ### list_all_cards See the full list of 78 tarot cards including their names, numbers, and suits. Use this to browse the entire deck. ## Prompt Examples **Prompt:** ``` Pull a card for my daily reading. ``` **Response:** ``` Your card for today is **The Empress** (III) — Major Arcana. Keywords: fertility, femininity, beauty, nature, abundance. This card suggests nurturing energy and creative growth. Embrace beauty and abundance in your life today. ``` **Prompt:** ``` Give me a three-card past/present/future reading. ``` **Response:** ``` Your three-card spread: **Past**: The Tower. Sudden change and upheaval. A structure in your life crumbled, making way for new growth. **Present**: Four of Pentacles. Holding on tight to resources. You may be feeling protective of what you have. **Future**: The Star. Hope, renewal, and inspiration. After the storm, peace and healing are coming. ``` **Prompt:** ``` What does The Fool card mean in tarot? ``` **Response:** ``` **The Fool (0)** — Major Arcana. Keywords: innocence, beginnings, freedom, a free spirit. Upright meaning: new beginnings, optimism, trust, and the start of a journey. Reversed meaning: recklessness, risk-taking, naivety. Fortune telling: a new adventure is beginning; embrace the unknown with an open heart. ``` ## Capabilities ### Pull a random card for daily guidance Your agent draws a single card and provides its keywords and interpretation for your day. ### Browse the full 78-card deck Access every card in the Major and Minor Arcana with full descriptions and imagery. ### Get detailed card meanings Retrieve specific meanings for both upright and reversed card positions instantly. ### Perform multi-card spreads Draw several cards at once for layouts like past, present, and future or the Celtic Cross. ### Search cards by keywords Find specific cards based on interpretive meanings or general text queries. ### Access card imagery and classifications Get full descriptions and arcana types for any card in the deck. ## Use Cases ### Daily Reflection A user asks for a card to start their day. The agent uses `get_random_card` to provide a daily focus and keywords. ### Relationship Advice A user wants to know about a new crush. The agent uses `get_multiple_random_cards` for a three-card spread layout. ### Tarot Study A student wants to know about a specific card. The agent uses `get_card` to show the full description and imagery. ### Content Research A blogger wants cards about 'healing'. The agent uses `search_cards` to find relevant cards for a social media post. ## Benefits - Stop manual lookups. Use `get_card` to instantly see meanings for both upright and reversed positions. - Build spreads faster. Use `get_multiple_random_cards` to pull 3 or more cards for past, present, and future readings. - Find cards by theme. Use `search_cards` to find every card matching a specific keyword like 'abundance'. - Get daily guidance. Use `get_random_card` to pull a single card for a morning reflection without any extra steps. - Browse the full deck. Use `list_all_cards` to see every card in the Major and Minor Arcana in one view. ## How It Works The bottom line is you get instant access to a full tarot deck's wisdom through your AI client. 1. Subscribe to the TarotAPI MCP on Vinkius. 2. Connect your preferred AI client like Claude or Cursor. 3. Ask your agent to pull a card, search for a meaning, or perform a spread. ## Frequently Asked Questions **Can I use TarotAPI for daily tarot readings?** Yes, it is perfect for that. Your AI agent can pull a random card every morning to give you a daily focus or reflection. **Does TarotAPI support reversed card meanings?** Yes, it does. When your agent pulls a card, it includes both upright and reversed interpretations so the reading is complete. **Can I do complex spreads like the Celtic Cross with TarotAPI?** Definitely. The Connector supports drawing multiple cards at once, making it easy to do past, present, and future layouts. **How do I search for specific tarot card meanings using TarotAPI?** You can just ask your agent to find cards related to a specific theme like 'career' or 'love'. It will search the keywords and return the best matches. **Is there a limit to the cards I can access with TarotAPI?** No, it gives you access to the full 78-card deck, including all Major and Minor Arcana. **Do I need a special API key for TarotAPI?** No, it is free and open. You just connect it through Vinkius and start chatting with your agent. **Do I need an API key or account?** No! TarotAPI is completely free and open with no authentication required. **How many cards are in the deck?** The deck contains all 78 traditional tarot cards: 22 Major Arcana and 56 Minor Arcana (Wands, Cups, Swords, Pentacles). **Can I do a three-card past/present/future reading?** Yes! Use `get_multiple_random_cards` with count=3 to draw three cards for a past/present/future spread.