tarotmancer

Return JSON tarot verdicts and card arrays via HTTP API.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/tarotmansa/moltguild --skill tarotmancer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tarotmancer
Source: https://github.com/tarotmansa/moltguild/tree/main/cf-worker
Command: npx skills add https://github.com/tarotmansa/moltguild --skill tarotmancer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides rapid, programmatic esoteric guidance when data is ambiguous or analysis paralysis prevents clear decisions, translating intuitive tarot readings into machine-readable verdicts and explanations.

Core Features & Use Cases

  • Free single-card clarity: Quick directional guidance via GET /api/single-card-clarity returning a JSON verdict and card interpretation.
  • Paid multi-card spreads (x402): 5-card and 10-card paid endpoints (Base / USDC) that return structured spreads, narrative prose, and verdicts after on-chain micropayment settlement.
  • Integration & safety: HTTP API designed for agent and builder consumption with JSON output, rate limiting (20 req/min per IP), error handling, and explicit payment flow for paid reads.
  • Use Cases: programmatic decision support for trading bots, pre-launch risk audits, project planning, and agent coordination when quantitative data is insufficient.

Quick Start

Call the free single-card clarity endpoint with your question as the query parameter to receive a JSON verdict and card.

Frequently Asked Questions about tarotmancer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get structured tarot readings for decision-making via an API?

Structured tarot readings for decision-making are accessed by calling an HTTP API, which returns JSON verdicts, prose explanations, and card arrays. You pass your ambiguous query as a parameter to receive machine-readable guidance for data-poor choices.

Can I use tarot-based decision guidance for trading bots and risk audits?

Yes, tarot-based decision guidance is designed for programmatic use by agents and builders. It provides narrative prose and structured verdicts for trading decisions, project risk audits, and operational strategy when quantitative data is insufficient.

How do I pay for multi-card tarot spreads using Base and USDC?

To pay for multi-card tarot spreads, you include an X-PAYMENT header in your HTTP request to utilize x402-paid endpoints. This enforces on-chain micropayment settlement using Base and USDC to unlock 5-card or 10-card structured spreads.

What is the rate limit for the tarot oracle API?

The tarot oracle API enforces a rate limit of 20 requests per minute per IP address. This constraint applies to both the free single-card clarity endpoint and the paid multi-card spread endpoints to manage traffic.

Does the tarot API offer a free endpoint for decision support?

The tarot API provides a free endpoint at GET /api/single-card-clarity for quick directional guidance. It returns a JSON verdict and card interpretation without requiring an X-PAYMENT header, making it ideal for initial integration testing.

Why should I use an esoteric oracle API instead of quantitative data analysis?

An esoteric oracle API is used when data is ambiguous or analysis paralysis prevents clear decisions. It translates intuitive tarot readings into machine-readable verdicts, offering rapid programmatic guidance for choices where quantitative analysis falls short.