Frequently Asked Questions
Everything you need to know about building astrology, tarot, numerology, and prediction apps with RoxyAPI and MCP for AI agents
Pricing & Billing
How does RoxyAPI billing work - monthly plans, yearly plans, or pay-per-request pricing?
RoxyAPI offers simple subscription-based billing with monthly and yearly plans in 2026. Annual subscriptions save about 20% compared to monthly billing. All plans include access to every API endpoint with no per-endpoint charges, instant API key delivery, comprehensive documentation, MCP integration, and email support. We do not use complex pay-per-request pricing like some competitors - predictable monthly costs help developers & businesses budget effectively. Request quotas reset on the 1st of each calendar month (UTC timezone). Upgrade or downgrade anytime with instant activation and pro-rated billing adjustments.
Does every API request cost the same on RoxyAPI, or do different endpoints have different prices like credit-based APIs?
With RoxyAPI, every request costs the same. A planet position call and a full birth chart call both count as one request. There is no credit math, no variable costs per endpoint, no surprises on your bill. Unlike credit-based APIs where a basic Panchang call might cost 10 credits but a Kundali costs 300 credits and a PDF report costs 350,000 credits, RoxyAPI uses flat per-request pricing across all 2026 plans. Your Starter plan gives you 5,000 requests, and each request is equal regardless of which endpoint you call or how complex the calculation is. This means you can predict your monthly costs exactly, you never run out of credits mid-month because a few users hit expensive endpoints, and you never need to buy add-on credit packs. One subscription, one price per request, all domains included.
What happens if I exceed my monthly API request limits - overage charges or service suspension?
When you reach your monthly request limit, RoxyAPI returns HTTP 429 (Too Many Requests) responses until your quota resets or you upgrade plans - we never charge surprise overage fees in 2026. Unlike some competitors with unexpected overage charges, RoxyAPI provides clear limit enforcement and transparent upgrade paths. Monitor usage in real-time via the /usage api OR the "X-RateLimit-Limit, X-RateLimit-Used and X-RateLimit-Remaining" headers in each api response. Upgrade plans instantly (within seconds) to increase limits immediately without waiting for approval or next billing cycle. For temporary traffic spikes, our Business plan provides headroom for growth, or visit our contact page for custom enterprise quotas. This fair, predictable billing protects developers from unexpected costs while ensuring continuous service for users within purchased limits.
Can I upgrade or downgrade my RoxyAPI subscription plan anytime, or am I locked into annual contracts?
RoxyAPI offers flexible subscription management with instant plan changes in 2026 - no annual contracts or lock-in periods. Upgrade from Starter to Professional or Business anytime with immediate limit increases and pro-rated billing (credit unused portion of current plan toward upgrade cost). Downgrade from higher tiers with changes taking effect at next billing cycle to avoid losing prepaid access. Annual subscriptions can be modified mid-term with pro-rated adjustments. Cancel subscriptions anytime with continued access through current billing period (no refunds for unused time, similar to streaming service policies). This flexibility supports developers from early prototyping (Starter) through scaling to production (Business) without financial penalties or bureaucratic approval processes. Start small, grow fast.
Does RoxyAPI offer free trials or developer sandbox environments for testing before purchasing?
RoxyAPI provides comprehensive testing without requiring payment in 2026. Our Scalar interactive documentation at /api/docs enables testing all endpoints with sample data and viewing formatted responses. Explore birth chart generation, tarot readings, numerology calculations, dream interpretation, and I-Ching oracle readings with example parameters to understand response structures. For production-level testing with custom parameters (specific birth dates/times/locations, personalized names for numerology), subscribe to our Starter plan ($39/month, cancel anytime) which provides generous 5,000 monthly requests, sufficient for thorough integration testing and initial prototype development. Unlike free tier APIs with severe limitations, the Starter plan ensures realistic production testing with same infrastructure, response times, and data quality as higher tiers.
What payment methods does RoxyAPI accept for subscriptions in 2026?
Pay your way. We accept all major credit and debit cards (Visa, Mastercard, American Express) processed securely through PayPal for USD and Razorpay for INR. Digital wallets like Apple Pay and Google Pay work seamlessly. For annual subscriptions, cryptocurrency payments are available. Contact us to pay with crypto. All transactions use industry-standard encryption. Your payment information is never stored on our servers.
Can I get invoices and receipts for RoxyAPI subscriptions for business accounting and tax purposes?
Yes! RoxyAPI automatically generates detailed invoices and receipts for every payment in 2026. Access invoices through your account dashboard with downloadable PDFs containing billing date, plan details, payment amount, tax information (where applicable), and business identification numbers. Invoices include complete itemization (subscription tier, billing period, quantity of requests, applicable discounts) compliant with tax regulations in US, EU, and India. For businesses requiring purchase orders, W-9 forms, or specific invoice formatting, visit our contact page. Enterprise customers can receive NET 30 invoice billing with customized terms.
Does RoxyAPI offer educational discounts for students or non-profit pricing for charitable organizations?
RoxyAPI offers educational and non-profit discounts in 2026. Students and educators building astrology thesis projects, tarot research applications, or numerology academic studies can apply for discounted access. Non-profit organizations developing spiritual wellness tools or free public astrology services are also eligible for reduced pricing. Open-source project maintainers building publicly available astrology, tarot, numerology, dream interpretation, or I-Ching tools on GitHub can apply for sponsored access. Visit our contact page with verification documentation to discuss discount options.
What enterprise pricing options does RoxyAPI offer for large-scale applications with millions of requests?
RoxyAPI offers enterprise plans for high-volume applications in 2026. Our Enterprise plan ($699/month) includes 1,000,000 monthly requests, dedicated account manager, custom integration support, 99.95% uptime SLA with financial credits, priority feature requests, and SOC 2 compliance documentation. For applications requiring beyond 1M monthly requests, visit our contact page for custom quotes with volume discounts, dedicated infrastructure, flexible billing (NET 30/60 terms, annual prepay discounts), and white-label API options. Enterprise customers building astrology apps, AI agent platforms, or therapy platforms with integrated spiritual features get dedicated account management and custom rate limits.
Technical
What programming languages and frameworks does RoxyAPI support for integration?
RoxyAPI is a RESTful HTTP API compatible with all programming languages and frameworks in 2026. Works with JavaScript/TypeScript (Node.js, React, Vue, Angular, Svelte), Python (FastAPI, Django, Flask), Ruby (Rails), PHP (Laravel), Java (Spring Boot), Go, Swift (iOS), Kotlin (Android), C#/.NET, and any language that can make HTTP requests. Our comprehensive Scalar documentation includes curl examples and full OpenAPI specifications for automatic client generation with tools like openapi-generator or openapi-typescript. For MCP integration, use the official TypeScript SDK (@modelcontextprotocol/sdk) with any language supporting HTTP/SSE communication. All endpoints follow standard REST principles with JSON request/response bodies, making integration straightforward in any stack.
Does RoxyAPI provide comprehensive documentation, API reference, and code examples for developers?
Yes! RoxyAPI offers extensive developer resources in 2026. Our Scalar interactive documentation at /api/docs provides complete API reference with request/response examples, parameter descriptions, authentication details, and live testing interface for all 86+ endpoints across astrology, tarot, numerology, dream interpretation, and I-Ching. The /llms.txt and /llms-full.txt endpoints deliver AI-friendly documentation for Cursor, Windsurf, and GitHub Copilot. Documentation covers authentication (API key setup), endpoint references (all six intelligence domains), response schema specifications, error handling best practices, and rate limiting guidelines. Full OpenAPI specification enables automatic client generation in any language. Support channels include GitHub Discussions and our contact page.
How do I authenticate API requests with RoxyAPI - API keys, OAuth, or JWT tokens?
RoxyAPI uses simple API key authentication for all requests in 2026. After subscribing, your unique API key is generated instantly and displayed on the success page and dashboard. Include it in requests via X-API-Key header: `X-API-Key: your_api_key_here` or as query parameter: `?api_key=your_api_key_here` (useful for testing). API keys are cryptographically secure HMAC-signed strings for fast verification. No OAuth flows, no JWT token refresh complexity, no session management - just straightforward API key authentication. Keys never expire unless regenerated manually for security. For MCP integration, configure API key once in client settings - MCP handles authentication automatically. Store keys securely in environment variables (never commit to version control).
What are RoxyAPI rate limits and how do I handle HTTP 429 Too Many Requests responses?
RoxyAPI enforces monthly request quotas based on subscription plan: Starter (5,000/month), Professional (50,000/month), Business (200,000/month), Enterprise (1,000,000/month) in 2026. When exceeding limits, endpoints return HTTP 429 with error message explaining quota exhaustion and reset date. Check response headers for usage insights: X-RateLimit-Limit (total monthly quota), X-RateLimit-Remaining (requests left), X-RateLimit-Used (consumed count), X-RateLimit-Reset (next reset timestamp UTC). Monitor the /usage endpoint for approaching limits. Best practices: cache common requests (daily horoscopes, zodiac interpretations), upgrade proactively before hitting limits. Enterprise plans offer custom rate limits for traffic spikes.
Can I use RoxyAPI in serverless environments like AWS Lambda, Vercel, or Cloudflare Workers?
Absolutely! RoxyAPI is optimized for serverless and edge computing environments in 2026. Our APIs work seamlessly with AWS Lambda (Node.js, Python runtimes), Vercel serverless functions, Cloudflare Workers, Netlify Functions, Google Cloud Functions, and Azure Functions. Sub-100ms response times ensure requests complete within typical serverless timeout limits. Use HTTP client libraries (axios, node-fetch, ky) in function code with API key from environment variables. For edge deployments (Cloudflare Workers at 250+ locations), RoxyAPI's global CDN reduces latency to <50ms worldwide. Serverless architecture advantages: pay-per-invocation cost optimization (no idle server costs), automatic scaling for traffic spikes, zero infrastructure management. Example: Vercel Next.js app with API routes calling RoxyAPI for dynamic horoscope generation with edge caching.
Does RoxyAPI support CORS for browser-based JavaScript applications and single-page apps?
Yes! RoxyAPI supports Cross-Origin Resource Sharing (CORS) for all browser-based requests in 2026. Our servers return appropriate CORS headers (Access-Control-Allow-Origin: *, Access-Control-Allow-Methods: GET/POST/PUT/DELETE, Access-Control-Allow-Headers: X-API-Key/Content-Type) enabling direct API calls from React, Vue, Angular, Svelte, and vanilla JavaScript running in browsers. No proxy server or backend required for simple applications. However, for security best practices in production, we recommend proxying API calls through your backend to avoid exposing API keys in browser source code. Browser-based apps work great for demos, prototypes, and internal tools. For public production apps with user authentication, implement server-side proxy endpoint that adds API key server-side before forwarding to RoxyAPI.
How do I migrate from other astrology/tarot/numerology APIs to RoxyAPI?
Migrating to RoxyAPI from other astrology, tarot, or numerology providers is straightforward in 2026. RoxyAPI uses standard REST with clean JSON responses, making endpoint mapping simple. Our comprehensive Scalar documentation at /api/docs lets you compare response structures and find equivalent endpoints for common operations (birth chart calculation, tarot reading, horoscope generation, dream interpretation, I-Ching readings). Authentication is simple X-API-Key header, no complex OAuth flows to reconfigure. Most migrations complete in a few hours since RoxyAPI covers six intelligence domains under one API key, often replacing multiple separate provider integrations. For complex migrations, visit our contact page for guidance.
How do I get latitude and longitude coordinates for birth locations in my astrology app?
RoxyAPI requires geographic coordinates (latitude/longitude) for astrology calculations, but we intentionally don't provide geocoding services - keeping our platform lean and focused on data APIs in 2026. Use free geocoding solutions: 1) Nominatim (OpenStreetMap) - free, no API key needed for city search (https://nominatim.openstreetmap.org/search?q=London&format=json); 2) Browser Geolocation API - built into all browsers for current location (navigator.geolocation.getCurrentPosition()); 3) IP Geolocation - free tier services like ipapi.co or ipgeolocation.io for automatic location detection; 4) Mapbox Geocoding - 100,000 free requests/month for production apps. For typical implementations: use Nominatim for city search dropdowns, browser API for "use my location" buttons, and IP geolocation for default location. These solutions are more flexible, better maintained, and free compared to adding geocoding to RoxyAPI which would increase costs and complexity.
Use Cases
What types of applications can I build using RoxyAPI in 2026?
RoxyAPI enables building diverse spiritual and wellness applications in 2026: 1) Astrology apps (birth chart generators, daily horoscope platforms, compatibility checkers, transit notification services); 2) Dating apps (astrology-based matching like Struck/Pattern, compatibility analysis, relationship insights); 3) AI chatbots (Claude/OpenAI/Gemini powered astrology advisors, tarot reading bots, numerology coaches); 4) Therapy platforms (spiritual counseling tools, AI therapy assistants with astrological insights); 5) Meditation apps (guided sessions based on astrological timing, personalized practices); 6) Life coaching tools (career guidance using numerology, decision support via tarot); 7) E-commerce personalization (product recommendations based on zodiac signs); 8) Content generation (automated horoscope newsletters, social media astrology posts); 9) Gaming (astrology-themed games, personality-based character systems). Ideal for startups, indie developers, and enterprise spiritual wellness platforms.
Can I build a commercial astrology or tarot reading business using RoxyAPI and sell subscriptions to end users?
Absolutely! RoxyAPI licenses permit commercial use and reselling of astrology, tarot, numerology, dream interpretation, and I-Ching services to end users in 2026. Build profitable businesses like: 1) Premium horoscope subscription services; 2) One-time tarot reading purchases; 3) Relationship compatibility reports for dating apps; 4) Birth chart generation services; 5) AI chatbot subscriptions with spiritual guidance; 6) Dream journal apps with AI interpretation; 7) I-Ching oracle apps. RoxyAPI pricing scales with your revenue. Start with the Starter plan for initial users, upgrade as your subscriber base grows. One subscription covers all six intelligence domains, so your cost per user stays low as you add features across astrology, tarot, numerology, dreams, and I-Ching.
How do I build an AI astrology chatbot or AI tarot reader using RoxyAPI and OpenAI/Claude?
Building AI spiritual chatbots with RoxyAPI takes 4 steps in 2026: 1) Subscribe to RoxyAPI and get API key; 2) Configure MCP client (Claude Desktop/OpenAI/Cursor) with RoxyAPI MCP server URL and API key; 3) Create AI agent prompt template: "You are an expert astrologer and spiritual advisor. When users ask questions, use RoxyAPI tools to generate birth charts, draw tarot cards, calculate numerology, interpret dreams, or cast I-Ching readings. Provide interpretations in conversational, empathetic tone"; 4) Deploy chatbot interface (Telegram/WhatsApp/website widget) connected to AI agent. The AI automatically calls appropriate RoxyAPI endpoints based on user questions. Advanced features: memory for recurring users (remember birth details), follow-up questions (deeper analysis), multi-turn conversations (holistic guidance combining all six domains). Example use cases: "What career path suits my life path number 7?" triggers numerology API, "I dreamed about flying" triggers dream interpretation API.
Can I integrate RoxyAPI into existing therapy platforms, wellness apps, or mental health chatbots?
Absolutely! RoxyAPI seamlessly integrates into existing wellness ecosystems in 2026. Therapy platforms can add spiritual dimensions: when clients discuss relationship issues, AI therapist queries RoxyAPI compatibility analysis for additional insights; during career counseling, numerology life path calculation informs guidance. Mental health chatbots (Woebot, Wysa) enhance conversations with personalized astrology - mood tracking correlates with lunar cycles, coping strategies align with planetary transits. Meditation apps (Calm, Headspace) offer zodiac-specific guided sessions, astrological timing recommendations for practices. Corporate wellness programs integrate daily horoscope delivery, team compatibility reports, stress management based on astrological cycles. Example: "I'm feeling anxious today" → chatbot checks today's planetary transits → provides context: "Mercury retrograde may affect communication, practice grounding techniques" + generates personalized tarot guidance card.
Platform Overview
What is RoxyAPI and how is it different from other astrology and prediction APIs in 2026?
RoxyAPI is the intelligence layer powering the next generation of insight and prediction apps in 2026. Ship production-ready astrology, tarot, numerology, dream interpretation, and I-Ching applications in days instead of months. Unlike competitors who charge separately per domain, RoxyAPI gives you one subscription for 86+ endpoints across 6 intelligence domains with instant API key delivery. Native Model Context Protocol (MCP) integration enables seamless connections with OpenAI Agents, Claude Desktop, Gemini Agents, Cursor, Windsurf, and any MCP-compatible AI application - a capability no other insight infrastructure offers in 2026.
Why should I choose RoxyAPI over competitors for building astrology, tarot, and prediction apps?
RoxyAPI is the only insight infrastructure that combines six intelligence domains (astrology, tarot, numerology, dreams, I-Ching), instant activation, and native MCP support for AI agents in one subscription. While competitors charge separately per product with complex pricing, RoxyAPI provides 86+ endpoints across all domains with one API key. Our native MCP integration lets developers build AI-powered astrology chatbots, tarot readers, and spiritual AI apps with OpenAI, Claude, or Gemini in under 2 minutes. Production-ready with 99.9% uptime and enterprise-grade security.
What makes RoxyAPI the first MCP-native insight infrastructure for AI agents and developers?
RoxyAPI pioneered Model Context Protocol (MCP) integration for insight and prediction APIs in 2026, enabling AI agents to automatically discover and use astrology, tarot, numerology, dreams, and I-Ching endpoints without manual configuration. Developers building AI astrology chatbots with OpenAI, autonomous spiritual advisors with Gemini, or insight apps with Claude Desktop can integrate in under 2 minutes. No other insight or prediction API offers native MCP support with 86+ endpoints across 6 intelligence domains - making RoxyAPI the only AI-native insight infrastructure for builders in 2026.
Can I really access all six intelligence domains with just one subscription and one API key?
Yes! One subscription gives you access to astrology, tarot, numerology, dreams, and I-Ching — 86+ endpoints across 6 intelligence domains with native MCP tools. You receive one API key instantly after payment that works across all domains. Unlike competitors who charge per product separately, RoxyAPI provides transparent monthly and yearly plans with clear request limits and no hidden fees. This saves developers time, money, and complexity when building multi-domain insight apps and AI agents in 2026.
How fast can I start making API requests after subscribing to RoxyAPI?
Instantly! RoxyAPI provides the fastest activation in the industry - your API key is generated and displayed immediately after payment completion, typically within seconds. Unlike competitors with manual approval processes that can take hours or days, RoxyAPI enables instant activation for production use with access to 86+ endpoints across astrology, tarot, numerology, dreams, and I-Ching plus native MCP tools. Start making API requests within 60 seconds of subscribing. Ship your insight or prediction app this week, not this quarter.
Does RoxyAPI work with AI coding assistants like Cursor, Windsurf, and GitHub Copilot in 2026?
Yes! RoxyAPI provides AI-friendly documentation specifically designed for AI coding assistants in 2026. Our /llms.txt and /llms-full.txt endpoints deliver structured documentation that Cursor, Windsurf, GitHub Copilot, and other AI-powered development tools can parse and understand. Combined with our native MCP integration, developers using AI assistants can generate astrology, tarot, and numerology app integration code faster and with fewer errors. Simply reference RoxyAPI documentation URLs in your AI assistant prompts for instant access to guides, code examples, and best practices for building insight and prediction apps across all 6 intelligence domains.
Is RoxyAPI truly production-ready for commercial applications and startups in 2026?
Absolutely! RoxyAPI is production-grade infrastructure built for developers shipping commercial astrology apps, tarot readers, numerology platforms, dream journal apps, I-Ching tools, and AI-powered spiritual assistants in 2026. We maintain 99.9% uptime SLA with monitoring, automatic failover, and redundant infrastructure. Unlike hobby projects or beta platforms, RoxyAPI provides production-ready reliability with comprehensive OpenAPI documentation, Scalar interactive testing, usage tracking via response headers, native MCP integration for AI agents, and transparent pricing. Four plans from Starter to Enterprise scale with your application from prototype to production.
What pricing plans does RoxyAPI offer for developers and businesses in 2026?
RoxyAPI offers transparent pricing tiers: Starter ($39/month - 5,000 requests), Professional ($149/month - 50,000 requests), Business ($349/month - 200,000 requests), and Enterprise ($699/month - 1M requests). All plans include access to every intelligence domain (astrology, tarot, numerology, dreams, I-Ching), instant API key delivery, 86+ endpoints with native MCP tools, comprehensive OpenAPI documentation, usage analytics dashboard, and email support. Save 17% with annual subscriptions. Unlike competitors who charge per product, RoxyAPI includes all six domains in every plan. No hidden fees, no per-domain charges, no approval delays - just straightforward pricing that scales with your app.
MCP Integration
What is Model Context Protocol (MCP) and why does it matter for developers building AI applications in 2026?
Model Context Protocol (MCP) is an open standard developed by Anthropic that enables AI agents and applications to automatically discover, connect to, and use APIs without manual configuration. For developers building AI-powered insight and prediction apps in 2026, MCP eliminates weeks of integration work - instead of writing custom API clients, authentication flows, and error handling, AI agents can self-configure API connections in under 2 minutes. RoxyAPI is the first and only insight infrastructure with native MCP support, enabling seamless integration with OpenAI Agents, Claude Desktop, Gemini Agents, Cursor, Windsurf, and any MCP-compatible tool. Build AI astrology chatbots, tarot readers, and spiritual assistants 10x faster.
How do I integrate RoxyAPI with OpenAI Agents for building astrology or tarot chatbots?
Integrating RoxyAPI with OpenAI Agents using MCP takes under 2 minutes. After subscribing to any RoxyAPI plan, add our MCP server URL and your API key to your OpenAI Agent configuration. OpenAI will automatically discover all available RoxyAPI endpoints (astrology birth charts, tarot readings, numerology calculations, dream interpretation, I-Ching readings) and enable your agent to call them. No manual API documentation reading, no custom code writing, no authentication complexity. Build AI-powered astrology chatbots, tarot reading assistants, or spiritual wellness coaches that can generate birth charts, draw tarot cards, calculate life path numbers, interpret dreams, and cast I-Ching hexagrams through natural conversation.
Can I use RoxyAPI with Claude Desktop or Claude Projects for AI-powered applications?
Yes! RoxyAPI provides native MCP integration with Claude Desktop and Claude Projects in 2026. Configure Claude with our MCP server details and API key (displayed on your dashboard after subscription), and Claude will automatically access all RoxyAPI endpoints. Build conversational AI applications where users can ask Claude to generate their birth chart, draw tarot spreads, or calculate numerology compatibility - all powered by RoxyAPI's comprehensive data APIs. Claude can combine astrological insights with personality analysis, tarot interpretations with decision guidance, and numerology calculations with career advice. This seamless integration enables developers to create AI therapy chatbots, spiritual wellness assistants, and personalized guidance tools without writing API integration code.
Does RoxyAPI work with Google Gemini Agents for building AI chatbots and applications?
Absolutely! RoxyAPI supports Google Gemini Agents through our MCP protocol implementation in 2026. Gemini can automatically discover and call RoxyAPI endpoints for astrology calculations, tarot card draws, and numerology analysis without manual API integration. Build multimodal AI applications where Gemini generates visual birth chart diagrams with astrological insights, creates illustrated tarot reading interfaces with card interpretations, or produces numerology reports with personalized guidance. Our MCP integration enables Gemini to seamlessly combine its natural language understanding and generation capabilities with RoxyAPI's accurate astrological calculations and spiritual data - perfect for creating AI-powered wellness apps, meditation guides, and life coaching chatbots.
How do I set up RoxyAPI with Cursor or Windsurf for AI-assisted development in 2026?
Setting up RoxyAPI with Cursor or Windsurf using MCP takes 90 seconds. Add our MCP server configuration to your IDE settings with your API key from the RoxyAPI dashboard. Cursor and Windsurf can then automatically generate API integration code, suggest optimal endpoint usage, and write complete application features using RoxyAPI. Ask Cursor to "build an astrology compatibility checker using RoxyAPI" and watch it generate complete React components with proper error handling, TypeScript types, and beautiful UI - all using our APIs correctly. This AI-assisted development workflow, powered by MCP, reduces astrology/tarot/numerology app development time from weeks to hours.
What AI platforms and tools support MCP protocol integration with RoxyAPI in 2026?
RoxyAPI's MCP integration works with all major AI platforms supporting Model Context Protocol in 2026: OpenAI Agents, Claude Desktop, Gemini Agents, Cursor IDE, Windsurf IDE, Zed editor, and any custom application using the MCP SDK. AI agent frameworks like LangChain and CrewAI can also connect to RoxyAPI through MCP. This broad compatibility ensures developers can use RoxyAPI with their preferred AI development tools without vendor lock-in. As new MCP-compatible platforms emerge, RoxyAPI integration works automatically without code changes.
Do MCP tool calls count against my monthly API request quota, or are they free?
MCP tool calls count as regular API requests against your monthly subscription quota. However, MCP tool discovery and schema inspection (when AI agents explore available endpoints) do not consume request credits - only actual data-fetching calls (generating birth charts, drawing tarot cards, calculating numerology) count toward limits. This design ensures fair usage while enabling AI agents to efficiently explore RoxyAPI capabilities. Monitor your usage in real-time through our analytics dashboard with per-endpoint breakdowns. If approaching limits, upgrade plans instantly with immediate activation - no approval waiting, no downtime. Our transparent request counting and usage visualization help developers budget effectively for AI agent workloads.
Can I build multi-agent AI systems that use RoxyAPI for astrology, tarot, and numerology insights?
Yes! RoxyAPI's MCP integration enables sophisticated multi-agent AI architectures in 2026. Build systems where specialized AI agents collaborate: an astrology agent generates birth charts, a tarot agent provides guidance through card spreads, a numerology agent calculates life path numbers, a dream interpretation agent analyzes symbolism, an I-Ching agent casts hexagram readings, and a synthesis agent combines insights into personalized wellness recommendations. Each agent can independently call RoxyAPI endpoints through MCP without custom API client code. Perfect for building AI therapy platforms, spiritual wellness apps, personalized life coaching chatbots, and comprehensive guidance systems. All six intelligence domains are accessible through one API key with consistent rate limiting across all agent requests.
How secure is MCP integration with RoxyAPI, and who can access my API key?
RoxyAPI MCP integration implements production-grade security in 2026. Your API key is stored locally in your MCP client configuration and transmitted only over HTTPS encryption. Authentication uses secure HMAC-based verification with rate limiting. MCP connections are isolated per developer account. For team environments, create separate API keys per developer with individual usage tracking. Unlike traditional API setups where keys might be exposed in source code or version control, MCP configuration keeps credentials secure in local environment files. Store keys in environment variables and never commit them to version control.
Can I test RoxyAPI MCP integration locally before deploying AI applications to production?
Absolutely! RoxyAPI provides comprehensive local development support for MCP integration. Configure your local Cursor, Windsurf, or Claude Desktop with our MCP server and test astrology calculations, tarot readings, numerology analysis, dream interpretation, and I-Ching readings in your development environment. Our Scalar interactive documentation at /api/docs enables testing individual endpoints with custom parameters and viewing formatted responses. Use the same API key for local development and production. This seamless dev-to-prod workflow accelerates AI application development and ensures your chatbots and agents work correctly before user deployment.
What happens if MCP protocol gets updated - will RoxyAPI automatically support new versions?
Yes! RoxyAPI maintains MCP protocol compatibility automatically in 2026. As Anthropic and the open-source community release new MCP versions with enhanced capabilities, we update our implementation with backward compatibility for existing integrations. Our engineering team monitors the MCP specification repository and implements updates within days of release. Developers receive automatic protocol upgrades without code changes or API key regeneration. This future-proof approach ensures your AI agents built with RoxyAPI continue working as MCP evolves, while gaining access to new protocol features like enhanced streaming, batch operations, and improved error handling. We also contribute to the MCP open-source community with data API-specific extensions.
Can non-technical users use AI agents with RoxyAPI, or is it only for developers?
While RoxyAPI is developer-focused, non-technical users can leverage applications built by developers using our MCP integration in 2026. For example, an astrology app developer creates a Claude-powered chatbot using RoxyAPI - end users simply chat with the bot to get birth chart analysis without knowing APIs exist. However, non-developers can also configure Claude Desktop or similar tools with RoxyAPI MCP integration by following our step-by-step setup guides (copy-paste configuration, no coding required). This enables spiritual practitioners, astrologers, tarot readers, and numerologists to use AI assistants enhanced with accurate calculations and interpretations from RoxyAPI without programming knowledge. Our goal: make AI-powered spiritual tools accessible to everyone.
API Features
What astrology features and calculations does RoxyAPI provide for developers in 2026?
RoxyAPI offers comprehensive astrology APIs covering both Western and Vedic systems in 2026. Western astrology endpoints include natal birth chart generation with house systems (Placidus, Koch, Whole Sign, Equal), planetary positions and aspects, zodiac sign interpretations (Sun/Moon/Rising), daily/weekly/monthly horoscopes, synastry compatibility analysis, composite charts, and transit calculations. Vedic astrology (Jyotish) APIs provide Rashi charts, Navamsa divisional charts, Vimshottari dasha period calculations, yoga combinations, Panchang (muhurta timing), dosha analysis, and KP astrology endpoints. All calculations use high-precision astronomical ephemeris data for accuracy, with JSON responses optimized for web and mobile applications. Perfect for building astrology apps, dating compatibility checkers, personalized horoscope platforms, and AI astrology chatbots.
What tarot reading capabilities does RoxyAPI offer for building tarot apps and chatbots?
RoxyAPI provides complete tarot API functionality with the full 78-card Rider-Waite deck in 2026. Our endpoints support single card draws, three-card spreads (past-present-future), Celtic Cross layouts (10 cards), love spreads, career guidance spreads, yes/no oracle readings, and custom multi-card readings. Each card response includes upright and reversed meanings, domain-specific interpretations (love, career, health, spiritual growth), image descriptions, symbolism, and contextual advice. The API includes seeded randomness for reproducible daily draws and spread position context. Ideal for building tarot reading apps, daily card websites, AI tarot assistants, and spiritual guidance platforms.
What numerology calculations and systems does RoxyAPI support for developers building numerology apps?
RoxyAPI numerology APIs use the Pythagorean system with comprehensive calculations in 2026. Our endpoints compute Life Path numbers, Expression/Destiny numbers, Soul Urge numbers, Personality numbers, Birthday numbers, and Personal Year cycles. Advanced features include name-to-number conversions (Pythagorean 1-9 and master numbers 11/22/33), compatibility analysis between life path combinations, karmic debt numbers (13/14/16/19), and karmic lesson detection. All responses include detailed numerological interpretations, personality insights, compatibility guidance, and life path recommendations. Perfect for building numerology calculator apps, name analysis tools, compatibility checkers, AI numerology chatbots, and personalized life path guidance platforms.
Does RoxyAPI provide daily horoscopes, weekly horoscopes, and monthly horoscopes for all zodiac signs?
Yes! RoxyAPI generates fresh daily, weekly, and monthly horoscopes for all 12 zodiac signs (Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces) in 2026. Our horoscope APIs use real-time planetary transits and astronomical data to produce accurate astrological forecasts covering love and relationships, career and finance, health and wellness, and personal growth. Horoscopes are generated programmatically using precise ephemeris calculations and astrological interpretation algorithms, not pre-written generic content. Responses include current planetary influences, upcoming significant transits, and personalized advice. Perfect for building horoscope websites, daily notification apps, email newsletters, and AI astrology chatbots that provide timely guidance.
Can I build astrology dating apps or relationship compatibility platforms using RoxyAPI?
Absolutely! RoxyAPI is ideal for building astrology dating apps and compatibility platforms in 2026. Our synastry compatibility endpoints analyze birth chart harmonies between two people, calculating aspect patterns (conjunctions, trines, squares, oppositions), composite charts, Venus-Mars connections for romantic attraction, Moon sign emotional compatibility, and overall relationship potential scores. Get detailed compatibility breakdowns for love, friendship, business partnerships, and family dynamics. APIs return percentage scores, narrative interpretations, challenge areas, and growth opportunities. Perfect for creating astrology-based dating apps like Struck or Pattern, relationship compatibility checkers, AI matchmaking chatbots, couples counseling tools, and friendship compatibility platforms. Combine with AI agents to provide real-time relationship advice through conversational interfaces.
Does RoxyAPI support birth chart generation with accurate house cusps, planetary positions, and aspect calculations?
Yes! RoxyAPI generates astronomically accurate birth charts using high-precision ephemeris data in 2026. Our natal chart endpoints calculate precise planetary positions (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, Chiron) with degrees, minutes, and zodiac signs. House systems supported include Placidus, Koch, Whole Sign, and Equal with exact house cusp calculations. Major and minor aspects (conjunction 0 degrees, sextile 60 degrees, square 90 degrees, trine 120 degrees, opposition 180 degrees) are computed with configurable orbs. Responses include sign rulers, planetary dignities (domicile, exaltation, detriment, fall), element/modality distributions, and aspect patterns. Perfect for building professional-grade astrology software, birth chart generators, and detailed natal analysis tools.
Can I create AI-powered astrology chatbots that answer natural language questions using RoxyAPI?
Absolutely! RoxyAPI with MCP integration enables building sophisticated AI astrology chatbots in 2026. Connect Claude, OpenAI, or Gemini to RoxyAPI, and users can ask natural questions like "What does my Moon in Scorpio mean?" or "Should I start a business this month based on my transits?" The AI agent automatically calls appropriate RoxyAPI endpoints (birth chart calculation, transit analysis, horoscope generation) and synthesizes personalized responses combining astrological data with conversational context. Build chatbots for spiritual wellness apps, therapy platforms, life coaching tools, daily guidance services, and meditation apps. Our MCP integration eliminates traditional chatbot limitations - instead of scripted responses, deliver real astrological calculations with AI-generated natural explanations. Perfect for Telegram bots, WhatsApp business accounts, website chat widgets, and voice assistants.
What data formats and response structures does RoxyAPI use for API responses?
RoxyAPI returns clean, well-structured JSON responses optimized for modern web and mobile development in 2026. All endpoints return data directly (like Stripe and GitHub APIs) with no wrapper objects. Astrological data includes nested objects for planetary positions, house placements, aspect lists, and interpretations. Tarot responses contain card arrays with properties (name, arcana, position, meanings, image descriptions). Numerology endpoints return calculation objects with number values, meanings, compatibility scores. Dream interpretation and I-Ching endpoints return structured symbolic analysis with interpretive text. Error responses use standard HTTP status codes (400 Bad Request, 401 Unauthorized, 429 Too Many Requests, 500 Server Error) with descriptive error messages. Perfect for React, Vue, Angular apps and mobile development with Swift/Kotlin.
Does RoxyAPI support batch requests or webhooks for processing multiple calculations at once?
RoxyAPI uses RESTful endpoints for individual calculations. For processing multiple birth charts, tarot readings, numerology calculations, dream interpretations, or I-Ching readings, make parallel async requests using Promise.all() in JavaScript or equivalent in other languages. Our infrastructure handles concurrent requests efficiently with fast response times. For high-volume batch processing (1000+ calculations), visit our contact page for custom solutions. Batch endpoints and webhook support for event-driven architectures are on our roadmap. MCP integration enables AI agents to orchestrate multiple RoxyAPI calls seamlessly within agent workflows.
Can I customize astrological calculation parameters like orbs, house systems, and zodiac types with RoxyAPI?
Yes! RoxyAPI supports extensive customization for professional astrologers and advanced developers in 2026. Western birth chart endpoints accept parameters for house system selection (Placidus, Koch, Whole Sign, Equal), tropical zodiac, and aspect orb configuration. Vedic astrology endpoints use the sidereal zodiac with Lahiri ayanamsa, Vimshottari dasha calculations, Navamsa divisional charts, and KP (Krishnamurti Paddhati) astrology with sub-sublord tables. Both systems calculate precise planetary positions including outer planets and Chiron. Advanced users can specify coordinates with timezone offsets for accurate house cusp calculations. These options enable building professional astrology software matching specific Western and Vedic astrological traditions.
Support
Does RoxyAPI help developers who are new to working with APIs or need integration guidance?
Yes! RoxyAPI offers free integration guidance for all active subscribers in 2026. If you are new to working with APIs or need help getting started, our team provides personalized setup guidance for your specific tech stack (React, Vue, Angular, Next.js, Python, PHP, Ruby, mobile, WordPress, and more). We help you understand the right endpoints for your use case, walk you through authentication setup, share code examples tailored to your project, and troubleshoot common integration questions. Simply visit our contact page with details about your project and what you are building, and our team will point you in the right direction. This is ideal for entrepreneurs, designers, and founders building astrology apps, tarot platforms, numerology tools, dream journals, or I-Ching applications who want expert guidance to get up and running quickly.
What customer support channels does RoxyAPI offer for developers in 2026?
RoxyAPI provides developer support in 2026: 1) Email support via contact page with responsive turnaround for all plans, priority response for Business and Enterprise plans; 2) Comprehensive Scalar interactive documentation with live testing, full OpenAPI reference, and FAQ; 3) GitHub Discussions for community support, feature requests, and code sharing; 4) AI-friendly documentation at /llms.txt and /llms-full.txt for Cursor, Windsurf, and other AI coding assistants. Enterprise customers get dedicated Slack channels with direct engineering access. Report bugs via GitHub Issues with priority fixes for critical problems.
Does RoxyAPI have status page or uptime monitoring for tracking API availability and incidents?
RoxyAPI monitors API health and availability continuously in 2026. Our infrastructure is built for production reliability with 99.9% uptime SLA on Professional plans and above. Monitor your own usage in real-time via the X-RateLimit response headers (X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Remaining) included in every API response. For service status inquiries or to report issues, visit our contact page. Our architecture uses redundant infrastructure with automatic failover to maintain consistent availability across all six intelligence domains (astrology, tarot, numerology, dreams, and I-Ching).
How can I request new features, API endpoints, or improvements to RoxyAPI in 2026?
RoxyAPI welcomes feature requests through multiple channels in 2026: 1) GitHub Discussions, where the community can upvote ideas and high-voted features get priority; 2) Visit our contact page with detailed use case descriptions; 3) Direct engineering feedback for Business and Enterprise customers. We are actively expanding across all six intelligence domains (astrology, tarot, numerology, dreams, I-Ching) with new endpoints, additional house systems, deeper compatibility analysis, and expanded Vedic astrology features. Features ship regularly based on demand and complexity. Custom API development is available for Enterprise customers with specific calculation requirements.
Still have questions?
We're here to help