Vinkius
TarotAPI

TarotAPI MCP for AI. Access structured card data and multi-card readings.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

TarotAPI MCP on Cursor AI Code EditorTarotAPI MCP on Claude Desktop AppTarotAPI MCP on OpenAI Agents SDKTarotAPI MCP on Visual Studio CodeTarotAPI MCP on GitHub Copilot AI AgentTarotAPI MCP on Google Gemini AITarotAPI MCP on Lovable AI DevelopmentTarotAPI MCP on Mistral AI AgentsTarotAPI MCP on Amazon AWS Bedrock

Connect to your AI in seconds.

TarotAPI connects your AI client directly to a complete, structured 78-card tarot deck. It lets you pull random cards for daily guidance or run complex multi-card spreads—like the Celtic Cross—and get full interpretations on demand.

You can also search the whole deck using specific keywords or meanings.

What your AI can do

Get api info

Retrieves basic meta-information about the TarotAPI server setup.

Get card

Fetches detailed data for a specific card using its short name, including upright and reversed meanings and keywords.

Get random card

Generates a single, completely random card suitable for quick daily guidance or reflection.

+ 3 more capabilities included
Get Single Card Details

Retrieves a card's full data—keywords, description, upright/reversed meaning, and image—given its short name (e.g., 'ar01').

Generate Multi-Card Spreads

Pulls multiple random cards for structured readings like the Celtic Cross or simple three-card sequences.

Pull Daily Guidance Card

Gets one random card suitable for quick, daily reflection without needing specific inputs.

Search by Meaning or Keyword

Finds all cards in the deck that match a given text query, whether it's an upright meaning or general keyword.

List All Cards

Returns a full inventory of all 78 cards, including their names and unique short identifiers for later use.

Included with Plan

Waiting for input…

AI Agent

TarotAPI MCP Server: 6 Tools for Tarot Readings

These tools let your AI agent interact with the full tarot deck. You can pull random cards, search by keywords, or retrieve specific card details in a structured format.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using TarotAPI on Vinkius

Get Api Info

Retrieves basic meta-information about the TarotAPI server setup.

Get Card

Fetches detailed data for a specific card using its short name, including upright...

Get Random Card

Generates a single, completely random card suitable for quick daily guidance or...

Get Multiple Random Cards

Pulls several random cards simultaneously; this is useful for structured spreads...

List All Cards

Returns the full catalog of all 78 cards, listing their names, numbers, and...

Search Cards

Searches the entire deck based on general text queries or specific meanings (upright/reversed).

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The TarotAPI integration is available immediately — no restart needed.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on every call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with TarotAPI, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 5,100+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Every connection is secured and compliant automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog every week
TarotAPI MCP server cover

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TarotAPI. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This connection provides 6 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Finding a consistent interpretation for cards shouldn't require cross-referencing six different websites.

Currently, if you need to know what 'abundance' means across three different spreads—say, past, present, and future—you have to open multiple tabs. You pull up a basic meaning for the card, then search for its keywords in a second place, and finally check a third site just for the reversed definition. It’s manual, time-consuming data aggregation.

With TarotAPI, your agent handles this logic. Whether you use `get_multiple_random_cards` or run a single `get_card`, all three required meanings—upright meaning, keywords, and fortune telling interpretation—are returned in one clean JSON payload. You get the full context immediately.

TarotAPI MCP Server: Get structured card guidance instantly.

Before this server, generating a 'Past/Present/Future' reading was a multi-step process. You had to manually draw three cards, look up each one individually for its meaning, and then write the connection between them. The output was always disjointed.

Now, running `get_multiple_random_cards` provides all three interpretations—the Past, Present, and Future—structured under specific headers in a single API call. It eliminates the guesswork and gives you clean, ready-to-use narrative blocks.

What your AI can actually do with this

You gotta hook your AI client up with TarotAPI to get access to a complete, structured 78-card tarot deck. Forget general knowledge—this server gives you verified data for every single major and minor arcana card. When you run these tools, you're not just getting vague vibes; you’re pulling specific interpretations and keywords directly from the API structure.

To start up, you can use get_api_info to pull basic meta-information on how the server is set up. If you need a full inventory of what’s in the deck before running anything else, run list_all_cards. That tool returns the total catalog of all 78 cards, listing their official names, assigned numbers, and unique short identifiers that you'll need later.

When it comes to reading specific cards, your options are pretty deep. If you know exactly which card you want—say, The Tower or The Lovers—you use get_card. Just feed it the card’s short name (like 'ar01'), and it spits out all the detailed info: keywords, a full description, its meaning when upright, and what it means if it's reversed.

It gives you the whole package.

If you need to find cards based on something other than their name—maybe you’re looking for a card related to 'change' or 'communication'—you use search_cards. This tool searches the entire deck using general text queries, letting you pinpoint every card whose meaning or keyword matches what you type in. You can search by upright meanings or reversed interpretations.

For quick reads, you don’t gotta do much work. If you just want a single random card for daily reflection, run get_random_card. It immediately generates one completely arbitrary card, perfect for quick guidance without needing any inputs from your side. When you need more than one card—like running a full Celtic Cross spread or even just looking at past/present/future sequences—you call get_multiple_random_cards.

This tool pulls several random cards all at once, letting your agent handle structured layouts that require multiple specific placements.

These tools mean you control the entire reading process. You use list_all_cards to build your knowledge base; then you pull a single card with get_card; or if you're doing a spread, you hit it with get_multiple_random_cards. If all that fails, you can always narrow things down by querying the data using search_cards, making sure every interpretation you pass to your user is backed up by structured data.

You don’t have to guess; you just call the right tool.

Built · Hosted · Managed by Vinkius TarotAPI MCP Server - Structured Card Readings
Server ID 019d8487-d57d-7201-9c92-40c9381e69dc
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

Questions you might have

How do I get card details for a specific card using TarotAPI? +

Use the get_card tool. You must provide the short name (like 'ar01' or 'swac'). This returns all structured data, including both upright and reversed meanings.

Can I run a three-card spread using get_multiple_random_cards? +

Yes. get_multiple_random_cards is designed for this. It pulls multiple random cards simultaneously, making it perfect for structured layouts like Past/Present/Future.

What if I want to find all cards related to 'courage'? +

Use search_cards. You can query the tool with keywords or specific meanings. This will return every card in the deck that matches your search criteria.

Is there a way to see what cards are available for me to use? +

Run list_all_cards. This returns a complete inventory of all 78 tarot cards, giving you their names and the unique short identifiers needed for other tools.

Does TarotAPI support reversed card meanings? +

Yes. The get_card tool explicitly includes fields for both upright and reversed interpretations for every major arcana card.

Using the get_random_card tool, how can I pull a single card for quick daily guidance? +

The tool instantly returns one random tarot card. The response provides the full meaning, keywords, and interpretations right away. This is perfect when you need immediate reflection or general advice without specifying a particular card.

When I use the get_api_info tool, what technical details about TarotAPI should I expect? +

It provides essential metadata for the API. This information helps your AI client understand the service's structure and available endpoints before making a functional call.

If I try to run the get_card tool with an invalid short name, what error do I receive? +

The system returns a clear error message. This response specifies that the card identifier is incorrect and guides you toward using valid formats like 'ar01' or 'swac'.

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.

Built & Managed by Vinkius 30s setup 6 tools

We've already built the connector for TarotAPI. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 6 tools are live and waiting. You're up and running in seconds.

Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.