TarotAPI Connector for AI agents.
6 live capabilities
Get instant tarot readings and card meanings through your AI client.
Waiting for input…
Why people use TarotAPI
TarotAPI: Bringing Mystical Divination to Your AI Agent
With TarotAPI, your AI agent handles the deck. You just ask for a reading, and it pulls the correct card, interprets the meaning, and explains the keywords in one go. You get a cohesive experience where the magic stays in the conversation.
What Vinkius changes
You get instant access to a full tarot deck's wisdom through your AI client.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Daily Reflection
A user asks for a card to start their day.
- Real-world use case 02
Relationship Advice
A user wants to know about a new crush.
- Real-world use case 03
Tarot Study
A student wants to know about a specific card.
Complete set · 6capabilities
The complete TarotAPI capability set.
These are the exact actions your AI can choose when you ask it to work with TarotAPI.
01—03
3 capabilities in this set.
Part of 6 available through TarotAPI.
- 01 Capability
Get api info
Get general information about the TarotAPI service. This helps you understand the scope of the deck.
- 02 Capability
Get card
Get full meanings, keywords, and imagery for a specific card. Use short names like 'ar01' for quick lookups.
- 03 Capability
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.
04—06
3 capabilities in this set.
Part of 6 available through TarotAPI.
- 04 Capability
Get multiple random cards
Draw multiple random cards at once for complex spreads. This works for three-card past, present, and future layouts.
- 05 Capability
Search cards
Find specific cards by searching their meanings or keywords. It returns all cards that match your search criteria.
- 06 Capability
List all cards
See the full list of 78 tarot cards including their names, numbers, and suits. Use this to browse the entire deck.
Set up in minutes
One URL. Then ask TarotAPI to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use TarotAPI from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_2aMho9ZdDvIpegGYkrIzjb00rWFMVBEZY193Df2T/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it TarotAPI, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable TarotAPI for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_2aMho9ZdDvIpegGYkrIzjb00rWFMVBEZY193Df2T/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the TarotAPI URL.
- Step 03
Save and start
Save the connection and enable TarotAPI in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"tarotapi": {
"url": "https://edge.vinkius.com/vk_preview_2aMho9ZdDvIpegGYkrIzjb00rWFMVBEZY193Df2T/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using TarotAPI
Open Agent mode in chat and ask: "Using TarotAPI, help me...". 6 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"tarotapi": {
"url": "https://edge.vinkius.com/vk_preview_2aMho9ZdDvIpegGYkrIzjb00rWFMVBEZY193Df2T/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using TarotAPI
Ask Copilot: "Using TarotAPI, help me...". 6 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"tarotapi": {
"url": "https://edge.vinkius.com/vk_preview_2aMho9ZdDvIpegGYkrIzjb00rWFMVBEZY193Df2T/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using TarotAPI
Open Cascade and ask: "Using TarotAPI, help me...". 6 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"tarotapi": {
"url": "https://edge.vinkius.com/vk_preview_2aMho9ZdDvIpegGYkrIzjb00rWFMVBEZY193Df2T/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using TarotAPI
Ask Cline: "Using TarotAPI, help me...". 6 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add tarotapi --transport http "https://edge.vinkius.com/vk_preview_2aMho9ZdDvIpegGYkrIzjb00rWFMVBEZY193Df2T/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using TarotAPI
Ask Claude: "Using TarotAPI, show me...". 6 tools are ready
Where the request belongs
Work TarotAPI can move forward.
This is for spiritual practitioners who want a faster way to pull readings, content creators building divination apps, or anyone who enjoys the symbolism of tarot but hates flipping through physical books.
Tarot Reader
Uses it to quickly generate card details for clients or personal study without manual lookups.
Content Creator
Uses it to brainstorm mystical themes or generate daily vibes for social media content.
Spiritual Enthusiast
Uses it as a capability for personal reflection and daily guidance through a chat interface.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsAstrologyAPI
Leading global astrology platform. get daily horoscopes, birth charts, and numerology via AI.
Scryfall
Access the ultimate Magic: The Gathering database. search cards, fetch rulings, and explore sets directly from your AI agent.
Yu-Gi-Oh
Access the ultimate Yu-Gi-Oh! database. search for cards, explore archetypes, and check set lists directly from your AI agent.
Deck of Cards
Simulate a full deck of cards via the Deck of Cards API. shuffle, draw, manage piles, and create custom decks for games or simulations.
Tarot Spread Generator
Generate structured tarot readings using predefined spreads like Celtic Cross and Horseshoe.
Tarot Card Drawer
A cryptographically secure random generator for Tarot card draws, spreads, and deck analysis.
Bring your own AI
Change the model, client or framework. Keep TarotAPI connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about TarotAPI.
The practical details behind the request, access and result.
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.
One connection away
Give your agent a direct line to TarotAPI.
Connect TarotAPI once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available