Frequently Asked Questions

RoxyAPI offers simple subscription-based billing with monthly and yearly plans in 2026. Plans start at $39 per month, and annual billing works out to roughly two months free (about 17% off the monthly rate). Because every plan bundles all 18 domains, the unit that actually matters is the price per domain: $1.80 per domain per month on annual billing, against $12 or more for a typical single-domain astrology API. All plans include every API endpoint with no per-endpoint charges, instant API key delivery, comprehensive documentation, Remote MCP, and email support. We do not use complex pay-per-request pricing, so predictable monthly costs help developers and businesses budget effectively. Request quotas reset on the 1st of each calendar month (UTC timezone).

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 cost per endpoint, and no surprises on your bill. On a credit-metered API the same two calls do not cost the same: one published credit table (checked June 2026) charges 10 credits for a basic panchang and 2,000 for a single regional-calendar call, a 200x difference, with report modules reaching 75,000 credits each. That is why a credit balance drains at a rate you cannot forecast. RoxyAPI uses flat per-request pricing across all 2026 plans instead. Your Starter plan gives you 50,000 requests, each one equal regardless of which endpoint you call or how heavy the calculation is, and a complete natal chart or a full panchang comes back in a single request rather than several separately billed ones. You never run out of credits mid-month because a few users hit expensive endpoints, and you never buy add-on credit packs.

Only if you stop at the subscription line. A near-free engine is rented, not free: you take on hosting, ephemeris data currency, your own accuracy verification, and being on call when a chart is wrong at 2am, and none of that appears on the invoice. The licensing bill is the one that hurts most. A free calculation engine is usually built over Swiss Ephemeris, which is dual licensed as either a paid commercial license or the AGPL, and AGPL copyleft is triggered by a user reaching your service over the network, not by shipping code. Google bans AGPL-licensed code company-wide on that basis and says the risks heavily outweigh the benefits. Your app is a network service, so that liability lands on you, not on the library. Ask any provider which engine it runs and whether it holds a commercial license, and keep the reply. RoxyAPI is $1.80 per domain per month on annual billing, runs its own engine with clean commercial terms (see /policy/license), and carries the hosting, verification and on-call for you. The honest exception: if you need exactly one domain, you can run the infrastructure yourself, and the licensing does not apply to you, then a self-hosted library really is cheaper, and we will not pretend otherwise.

All payments are final and non-refundable. Before paying, every endpoint can be evaluated through the public Scalar console at /api-reference, free demo tools at /tools, free MCP tools/list discovery, and the open MIT-licensed templates at /templates. You can cancel your subscription at any time to stop the next renewal charge; access continues through the end of the current billing period with no proration. Limited exceptions are reviewed case by case for verified billing errors (within 7 days), extended platform outages exceeding 24 hours, and unauthorized charges. EU consumers expressly waive the 14-day right of withdrawal at checkout under Article 16(m) of EU Directive 2011/83. See /policy/refund for the full policy.

When you reach your monthly request limit, RoxyAPI returns HTTP 429 (Too Many Requests) responses until your quota resets, which happens on the 1st of the calendar month at 12:00 AM UTC regardless of when you subscribed, or until you subscribe to a higher tier - we never charge surprise overage fees in 2026. Monitor usage in real-time via the /usage api OR the "X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Remaining and X-RateLimit-Reset" headers in each api response, where X-RateLimit-Reset is the Unix timestamp of the rollover so a client can back off exactly once instead of polling. To move to a higher tier, click Change plan in your account dashboard: the higher quota applies as soon as the payment completes, on the same API key, and the unused value of your current plan carries over as extra days on the new billing period. For temporary traffic spikes, our Business plan provides headroom for growth, or visit our contact page for custom enterprise quotas.

Yes, both, anytime, with no lock-in periods and no cancellation fees. Click Change plan in your account dashboard, or pick a different tier at checkout while signed in, and your subscription moves to the new plan on the same API key. The new quota applies as soon as the payment completes, and the unused value of your current plan converts into extra days on the new billing period at the new plan rate, upgrades and downgrades alike. To keep your current quota for the days you already paid for, downgrade closer to your renewal date. Use the request headers (X-RateLimit-Used, X-RateLimit-Remaining) or the /usage endpoint to track consumption and pick the right tier.

RoxyAPI offers 20+ free interactive tool pages where you can test numerology calculators, tarot readings, I-Ching consultations, dream lookups, daily horoscopes, and birth charts without signing up in 2026. The interactive API reference at /api-reference is a live production environment not sandbox. Make live API calls against real endpoints immediately, no signup or credit card needed. For production-level testing with your own parameters, subscribe to our Starter plan ($39/month, cancel anytime) which provides 50,000 monthly requests, sufficient for integration testing and initial prototype development.

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. Cryptocurrency payments (Bitcoin) are available for monthly and annual subscriptions. Contact us to pay with crypto. All transactions use industry-standard encryption. Your payment information is never stored on our servers.

RoxyAPI offers enterprise plans for high-volume applications in 2026. Enterprise is quoted rather than listed, and starts at 10M monthly requests. It carries a dedicated account manager, custom integration support, 99.95% uptime SLA with financial credits, priority feature requests, completed security questionnaires, negotiated contract terms, and a named data protection contact. A GDPR Article 28 Data Processing Addendum with EU Standard Contractual Clauses is included on every plan at no extra cost, not just Enterprise. For volume at or beyond 10M monthly requests, visit our contact page for a quote 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.

RoxyAPI is a RESTful HTTP API compatible with all programming languages and frameworks in 2026. We ship official first-party typed SDKs for TypeScript / JavaScript (@roxyapi/sdk on npm), Python (roxy-sdk on PyPI), PHP (roxyapi/sdk on Packagist, PHP 8.2+, built on Saloon v4), C# / .NET (RoxyApi.Sdk on NuGet), and Go (github.com/RoxyAPI/sdk-go, standard library net/http). These cover the five largest server-side ecosystems for spiritual / insight apps: Node, Python, PHP (Laravel, Symfony, Slim, WordPress), .NET (ASP.NET Core, Blazor), and Go. Beyond the official SDKs, RoxyAPI works with JavaScript / TypeScript (Node.js, React, Vue, Angular, Svelte), Python (FastAPI, Django, Flask), PHP (Laravel, Symfony, WordPress), Ruby (Rails), Java (Spring Boot), Swift (iOS), Kotlin (Android), and any language that can make HTTP requests. Our comprehensive API 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 MCP SDK (TypeScript, Python, or any HTTP/SSE-capable language). All endpoints follow standard REST principles with JSON request/response bodies, making integration straightforward in any stack.

Yes! RoxyAPI offers extensive developer resources in 2026. Our interactive API reference at /api-reference provides complete API reference with request/response examples, parameter descriptions, authentication details, and live testing interface for all 259+ endpoints across Astrology, Vedic, Forecast, Human Design, Chinese Astrology, Feng Shui, Mesoamerican, Vastu, Numerology, Kabbalah, Tarot, Biorhythm, Ayurveda, I-Ching, Crystals, Dreams, Angel Numbers, and Location. 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 18+ intelligence domains), response schema specifications, error handling best practices, and rate limiting guidelines. Full OpenAPI specification enables automatic client generation in any language. Support is available via our contact page.

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).

RoxyAPI enforces monthly request quotas based on subscription plan: Starter (50,000/month), Professional (500,000/month), Business (3,000,000/month), Enterprise (custom, from 10,000,000/month) in 2026. Quotas run on the calendar month and reset on the 1st at 12:00 AM UTC, not on your renewal date, so an annual plan still refills every month. When exceeding limits, endpoints return HTTP 429 with an error message naming the reset instant. 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 (Unix timestamp of the next reset, 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.

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.

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/X-SDK-Client) enabling direct API calls from React, Vue, Angular, Svelte, and vanilla JavaScript running in browsers. The @roxyapi/sdk packages set X-SDK-Client automatically for analytics tagging, which is allowlisted at the gateway. 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.

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 API documentation at /api-reference lets you compare response structures and find equivalent endpoints for common operations (birth chart calculation, tarot reading, horoscope generation, dream interpretation, angel number lookup, crystal healing, 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 18+ intelligence domains under one API key, often replacing multiple separate provider integrations. For complex migrations, visit our contact page for guidance.

RoxyAPI ships its own location and timezone API, so a birth-data form never needs a second geocoding vendor in 2026. Send a city name to GET /api/v2/location/search?q=London and every result carries city, province, country, ISO code, latitude, longitude, population, the IANA timezone and its UTC offset, which is exactly the set a birth chart request needs, ranked so an exact name match comes first for autocomplete. GET /api/v2/location/countries and /api/v2/location/countries/{iso2} list every country and its cities for pickers. The same key covers all 18+ domains, and the Remote MCP server at /mcp/location lets an AI agent resolve the birthplace itself before it calls a chart tool. Two things are out of scope on purpose: reverse geocoding (coordinates to a place name) and IP geolocation. For the current position of a visitor, use the browser Geolocation API and pass the coordinates straight to the chart endpoint.

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); 10) No-code practitioner and creator sites (astrologers, tarot readers, and coaches who paste a copy-paste widget into Squarespace, Wix, Shopify, or WordPress and offer free readings that bring visitors back). Ideal for startups, indie developers, practitioners, and enterprise spiritual wellness platforms.

Absolutely! RoxyAPI licenses permit commercial use and reselling of Astrology, Vedic, Forecast, Human Design, Chinese Astrology, Feng Shui, Mesoamerican, Vastu, Numerology, Kabbalah, Tarot, Biorhythm, Ayurveda, I-Ching, Crystals, Dreams, Angel Numbers, and Location 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 18+ intelligence domains, so your cost per user stays low as you add features across Astrology, Vedic, Forecast, Human Design, Chinese Astrology, Feng Shui, Mesoamerican, Vastu, Numerology, Kabbalah, Tarot, Biorhythm, Ayurveda, I-Ching, Crystals, Dreams, Angel Numbers, and Location.

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, look up angel numbers, explore crystal properties, 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 18+ domains). Example use cases: "What career path suits my life path number 7?" triggers numerology API, "I dreamed about flying" triggers dream interpretation API.

Yes! RoxyAPI is perfect for automated content generation in 2026. Create: 1) Daily zodiac Instagram posts (query horoscope API, generate graphics with Canva API, post via Instagram Graph API); 2) Personalized email newsletters (calculate transits for subscriber birth charts, send via SendGrid/Mailchimp); 3) Blog content (weekly horoscope articles, monthly astrology forecasts); 4) Social media bots (Twitter/TikTok astrology accounts with automated daily posts); 5) Marketing personalization (segment email lists by zodiac sign, customize landing pages based on visitor birthdate). Combine RoxyAPI with AI writing tools (ChatGPT API) for unique content variations. Example workflow: fetch daily horoscope → GPT-4 rewrites in brand voice → schedule social posts. Perfect for astrology influencers, spiritual coaches, wellness brands, and content marketers scaling personalized engagement.

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.

RoxyAPI is the intelligence layer powering the next generation of insight and prediction apps in 2026. Ship production-ready Astrology, Vedic, Forecast, Human Design, Chinese Astrology, Feng Shui, Mesoamerican, Vastu, Numerology, Kabbalah, Tarot, Biorhythm, Ayurveda, I-Ching, Crystals, Dreams, Angel Numbers, and Location applications in days instead of months. Unlike competitors who charge separately per domain, RoxyAPI gives you one subscription for 259+ endpoints across 18 intelligence domains with instant API key delivery. Remote MCP servers per domain over Streamable HTTP enable seamless connections with OpenAI Agents, Claude Desktop, Gemini Agents, Cursor, Windsurf, and any MCP-compatible AI application. AGENTS.md ships in every SDK as the execution playbook for AI coding agents (Cursor, Codex, Windsurf, Aider, Claude Code, Gemini CLI). A capability no other insight infrastructure offers in 2026.

RoxyAPI is the only insight infrastructure that combines 18+ intelligence domains (Astrology, Vedic, Forecast, Human Design, Chinese Astrology, Feng Shui, Mesoamerican, Vastu, Numerology, Kabbalah, Tarot, Biorhythm, Ayurveda, I-Ching, Crystals, Dreams, Angel Numbers, and Location), instant activation, and Remote MCP servers for AI agents in one subscription. While competitors charge separately per product with complex pricing, RoxyAPI provides 259+ endpoints across all domains with one API key. Our Remote MCP servers (Streamable HTTP, no Docker, no self-hosting) and bundled AGENTS.md let 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.95%+ uptime and enterprise-grade security.

RoxyAPI pioneered Model Context Protocol (MCP) integration for insight and prediction APIs in 2026, enabling AI agents to automatically discover and use Astrology, Vedic, Forecast, Human Design, Chinese Astrology, Feng Shui, Mesoamerican, Vastu, Numerology, Kabbalah, Tarot, Biorhythm, Ayurveda, I-Ching, Crystals, Dreams, Angel Numbers, and Location 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 Remote MCP servers with 259+ endpoints across 18 intelligence domains - making RoxyAPI the only AI-native insight infrastructure for builders in 2026.

Yes! One subscription gives you access to Astrology, Vedic, Forecast, Human Design, Chinese Astrology, Feng Shui, Mesoamerican, Vastu, Numerology, Kabbalah, Tarot, Biorhythm, Ayurveda, I-Ching, Crystals, Dreams, Angel Numbers, and Location: 259+ endpoints across 18 intelligence domains with Remote MCP servers and AGENTS.md for AI coding agents. 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.

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 259+ endpoints across Astrology, Vedic, Forecast, Human Design, Chinese Astrology, Feng Shui, Mesoamerican, Vastu, Numerology, Kabbalah, Tarot, Biorhythm, Ayurveda, I-Ching, Crystals, Dreams, Angel Numbers, and Location plus Remote MCP servers. Start making API requests within 60 seconds of subscribing. Ship your insight or prediction app this week, not this quarter.

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 Remote MCP servers and bundled AGENTS.md execution playbook, developers using AI assistants can generate astrology, human design, and forecast 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 18 intelligence domains.

Absolutely! RoxyAPI is production-grade infrastructure built for developers shipping commercial astrology apps, tarot readers, numerology platforms, dream journal apps, angel number apps, crystal guides, I-Ching tools, and AI-powered spiritual assistants in 2026. We maintain 99.95%+ uptime with monitoring, automatic failover, and redundant infrastructure. Unlike hobby projects or beta platforms, RoxyAPI provides production-ready reliability with comprehensive OpenAPI documentation, interactive API reference, usage tracking via response headers, Remote MCP servers for AI agents, and transparent pricing. Four plans from Starter to Enterprise scale with your application from prototype to production.

RoxyAPI offers transparent pricing tiers: Starter ($39/month - 50,000 requests), Professional ($149/month - 500,000 requests), Business ($349/month - 3,000,000 requests), and Enterprise (custom pricing, from 10M requests). All plans include access to every intelligence domain (Astrology, Vedic, Forecast, Human Design, Chinese Astrology, Feng Shui, Mesoamerican, Vastu, Numerology, Kabbalah, Tarot, Biorhythm, Ayurveda, I-Ching, Crystals, Dreams, Angel Numbers, and Location), instant API key delivery, 259+ endpoints with Remote MCP servers, comprehensive OpenAPI documentation, usage analytics dashboard, and email support. Save 17% with annual subscriptions. Unlike competitors who charge per product, RoxyAPI includes all 18+ domains in every plan. No hidden fees, no per-domain charges, no approval delays - just straightforward pricing that scales with your app.

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 Remote MCP servers per domain, 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.

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, angel number meanings, crystal properties, 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.

Yes! RoxyAPI provides a Remote MCP server (Streamable HTTP) compatible 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.

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.

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.

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.

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.

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 angel numbers agent decodes repeating sequences, a crystals agent recommends healing stones, 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 18+ intelligence domains are accessible through one API key with consistent rate limiting across all agent requests.

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.

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, angel numbers, crystals, and I-Ching readings in your development environment. Our interactive API reference at /api-reference 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.

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.

AGENTS.md is the 2026 cross-tool standard for telling AI coding agents how to build on a given API. RoxyAPI publishes a tight execution playbook at /AGENTS.md (around 120 lines, imperative, blind-agent friendly) covering authentication, base URL, error contract, rate limits, idempotency, and the right endpoints for common tasks. It is read by Cursor, Codex, Windsurf, Aider, Claude Code, Gemini CLI, Zed, Warp, and RooCode. The same file ships inside the @roxyapi/sdk TypeScript package, the roxy-sdk Python package, the roxyapi/sdk PHP Composer package, the RoxyApi.Sdk NuGet package, and the sdk-go Go module, so coding agents pick it up automatically when they install the SDK in any of the five languages. Where llms.txt is for discovery and recommendation (the AI search surface, ChatGPT and Perplexity), AGENTS.md is for execution (the IDE coding agent that is actually writing your app). Use both. Point your agent at /AGENTS.md once and it stops hallucinating endpoint names, parameter shapes, and error codes.

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.

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/yearly 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 are powered by Roxy Ephemeris, verified against NASA JPL Horizons, with JSON responses optimized for web and mobile applications. Perfect for building astrology apps, dating compatibility checkers, personalized horoscope platforms, and AI astrology 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.

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.

Yes! RoxyAPI generates fresh daily, weekly, monthly, and yearly 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 computed by Roxy Ephemeris (verified against NASA JPL Horizons) to produce accurate astrological forecasts covering love and relationships, career and finance, health and wellness, and personal growth. Horoscopes are generated programmatically using Roxy 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.

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.

Yes! RoxyAPI generates astronomically accurate birth charts using Roxy Ephemeris, verified against NASA JPL Horizons 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.

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.

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, angel numbers, crystals, 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.

RoxyAPI uses RESTful endpoints for individual calculations. For processing multiple birth charts, tarot readings, numerology calculations, dream interpretations, angel number lookups, crystal queries, 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.

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.

Yes. RoxyAPI supports multi-language API responses in 10+ languages in 2026: English, Turkish, German, Spanish, Hindi, Portuguese, French, Russian, Chinese (Simplified), Chinese (Traditional). Add `?lang=es` (or any locale code such as hi, de, pt) to any endpoint to receive localized data. Translations cover tarot card meanings, crystal properties, dream symbol interpretations, I-Ching hexagram texts, angel number messages, numerology readings, and astrology interpretations. Each domain lists the languages it carries on its product page, and a code it does not carry yet returns English for that field rather than an error.

No. RoxyAPI is designed so developers with zero domain expertise can ship production-ready astrology, human design, forecast, and spiritual apps. Every calculation has been verified by domain practitioners against authoritative sources. You send birth data or a query, you get structured JSON back with every field documented and described. The API handles all the complex astronomy, Vedic mathematics, and domain logic internally. Vibe coders using Cursor, Replit, or Bolt can connect via MCP and have AI agents auto-discover all 256 tools without understanding the underlying calculations. You focus on the user experience, Roxy handles the intelligence.

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, .NET, 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, angel number apps, crystal guides, or I-Ching applications who want expert guidance to get up and running quickly.

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) Interactive API reference with live testing, full OpenAPI spec, and FAQ; 3) AI-friendly documentation at /llms.txt and /llms-full.txt for Cursor, Windsurf, and other AI coding assistants; 4) 6 open source templates on GitHub. Enterprise customers get dedicated Slack channels with direct engineering access.

Common RoxyAPI errors and solutions in 2026: 1) **401 Unauthorized** - Check API key format (correct header: `X-API-Key: your_key` or query param `?api_key=your_key`), verify key not expired/revoked, ensure no extra whitespace in key string; 2) **429 Too Many Requests** - Monthly quota exceeded, check usage via X-RateLimit headers, upgrade plan or wait for reset (1st of month UTC); 3) **400 Bad Request** - Invalid request parameters, check required fields (birth date/time/location for astrology), validate JSON syntax; 4) **500 Server Error** - Rare infrastructure issue, retry with exponential backoff, visit contact page if persistent; 5) **CORS errors** - Browser blocking cross-origin requests, add backend proxy or use server-side integration. For persistent issues, visit our contact page with curl command and request/response details for fast diagnosis.

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 18+ intelligence domains (Astrology, Vedic, Forecast, Human Design, Chinese Astrology, Feng Shui, Mesoamerican, Vastu, Numerology, Kabbalah, Tarot, Biorhythm, Ayurveda, I-Ching, Crystals, Dreams, Angel Numbers, and Location).

RoxyAPI welcomes feature requests in 2026. Visit our contact page with your use case and we prioritize based on demand. Business and Enterprise customers get direct engineering feedback. We are actively expanding across all 18+ intelligence domains with new endpoints, additional house systems, deeper compatibility analysis, multi-language support, and expanded Vedic astrology features. Features ship regularly. Custom API development is available for Enterprise customers with specific calculation requirements.