Official SDKs

The data layer for insight, belief, and prediction products.

RoxyAPI is the only multi-domain spiritual intelligence API. 140+ production endpoints across 12 genuinely distinct domains behind one API key, with remote MCP servers per product, verified astronomy, and clean commercial licensing. Distinct means distinct: astrology is one domain that includes natal charts, horoscopes, synastry, and transits, not three domains counted separately. Think of it as the Stripe of insight APIs: AI-native infrastructure for astrology, tarot, numerology, and prediction apps so builders can ship in days instead of months.

Every calculation is rigorously verified against authoritative sources. The proof is public, the breadth is one key, the licensing is clean.

One subscription gives builders production-ready access to every major spiritual and prediction domain through a single REST API and a single set of MCP servers. Domains in canonical order:

• Western astrology: natal charts, daily horoscopes, weekly and monthly horoscopes, synastry, compatibility scoring, transits, moon phase. Placidus, whole-sign, equal, and Koch house systems.
• Vedic and KP astrology: kundli, detailed panchang (rahu kaal, abhijit muhurta, brahma muhurta, choghadiya, hora), Vimshottari dasha (current period and full 120-year timeline), dosha analysis (Manglik, Kaal Sarp, Sade Sati), navamsa, 36-point Ashtakoota Guna Milan compatibility, plus KP sub-lord, sub-sub-lord, and ruling-planet horary. KP is the sharpest technical differentiator versus generic Vedic providers.
• Numerology: Life Path, full chart, compatibility, personal year, expression. Pythagorean reduction with master-number (11, 22, 33) and karmic-debt detection.
• Tarot: daily card, three-card spread, Celtic Cross, yes-no, love spread, custom draws. Deterministic seeded draws for once-per-day behavior.
• Human Design: full bodygraph (type, strategy, inner authority, profile, definition), defined and open centers, channels, gates, current transit overlay, and two-person connection (composite) charts.
• Forecast: cross-domain predictive timelines, transit windows, and significant-date detection across Western, Vedic, and biorhythm signals for any date range.
• Biorhythm: daily, multi-day forecast, compatibility, critical-day alerts. 10 cycle types.
• I Ching: 64-hexagram catalog, daily hexagram, three-coin cast with changing lines and resulting hexagram.
• Crystals: by zodiac, by chakra, birthstone, free-text search.
• Dream interpretation: symbol catalog, daily symbol, structured meanings.
• Angel numbers: by exact number, universal lookup with digit-root fallback, daily.
• Location and timezone resolution for accurate birth-data inputs (call this first when any chart endpoint needs coordinates).

Every endpoint returns structured JSON, ships rich field descriptions for tool-calling agents, and is callable from REST, the official SDKs, or remote MCP. Translated interpretations are available in 8 languages via the ?lang= parameter.

All three code SDKs are auto-generated from the OpenAPI specification, so new endpoints land in your IDE the day they ship. Each SDK ships an AGENTS.md so AI coding assistants in Cursor, Claude Code, Copilot, and Windsurf know how to call RoxyAPI without prompt-engineering.

The WordPress plugin is live on WordPress.org for no-code installs: drop a shortcode, no code required. Drop-in UI components that render natal wheels, kundli, panchang, tarot, numerology, and biorhythm from the API response ship as @roxyapi/ui.

RoxyAPI was MCP-first from day one. Every product domain ships its own remote Streamable HTTP MCP server. No local processes, no stdio wrappers, no self-hosting. Point Claude Desktop, Cursor, VS Code, Windsurf, or any MCP-compatible client at the URL and it is running in seconds.

The flagship multi-MCP reference integration is RoxyAPI/astrology-ai-chatbot, an MIT-licensed chatbot starter that wires multiple RoxyAPI MCP servers into a single conversational agent.

Astronomy is the one place AI confidently lies. RoxyAPI treats accuracy as the moat.

• Powered by Roxy Ephemeris, cross-referenced against NASA JPL Horizons DE441 as the physics ground truth.
• Vedic and KP outputs cross-referenced against DrikPanchang, onlinejyotish.com, JyotishApp, and timeanddate.com.
• Public methodology with tolerance thresholds and verification tables: roxyapi.com/methodology.
• Public, MIT-licensed benchmark anyone can clone, run, or point at any astrology API: RoxyAPI/astrology-api-benchmark. 210 reference planet positions across 21 birth charts, 210 of 210 within tolerance, median deviation 0.27 arcmin.
• No AGPL, no copyleft, no commercial-license entanglements passed to customers. Clean commercial licensing for production use.

Open-source starters that wrap RoxyAPI into a working app you can fork and ship:

• astrology-ai-chatbot: flagship multi-MCP astrology assistant
• astrology-starter-app: Western astrology baseline
• vedic-astrology-starter-app: Vedic and KP focused
• jyotish-vedic-astrology-app: Indian-market Jyotish app with Kundli, Panchang, Gun Milan, Dasha
• numerology-starter-app: Life Path, master numbers, karmic debt
• tarot-starter-app: tarot reader with seeded draws
• dreams-starter-app: dream journal with interpretation

1. Grab a key at roxyapi.com/pricing. Every plan includes every domain.
2. Try the live playground at roxyapi.com/api-reference.
3. Install an SDK or point your MCP client at one of the endpoints above.
4. Ship.

Questions, integration help, or partnership inquiries: roxyapi.com/contact.

Built by Roxy Labs. The Stripe of insight APIs.