Menu

  1. Docs
  2. Build With Roxy
  3. MCP Setup

MCP Setup

Roxy has native Model Context Protocol support. AI agents (Claude, GPT, Gemini) auto-discover all available tools without manual configuration.

What is MCP?

Model Context Protocol is an open standard for connecting AI agents to external APIs. Instead of writing integration code, your agent discovers what tools are available and calls them based on user questions. Think of it as API documentation for AI.

Roxy is the first insight and prediction infrastructure with native MCP support. No other astrology, tarot, or numerology API has this.

Integration Setup

Prerequisite: You need an API key. Get one instantly →

MCP Endpoint: https://roxyapi.com/mcp/dreams-api

Create or edit .vscode/mcp.json in your workspace:

{
  "servers": {
    "roxyapi-dreams-api": {
      "type": "http",
      "url": "https://roxyapi.com/mcp/dreams-api",
      "headers": {
        "X-API-Key": "your_api_key_here"
      }
    }
  }
}

Works with: GitHub Copilot (VS Code 1.102+), Cline, Continue, Roo Code. Reload VS Code after saving.

How it works

  1. Your AI agent connects to the MCP server URL
  2. It auto-discovers all available tools (endpoints) for that domain
  3. When a user asks a question, the agent picks the right tool and calls Roxy
  4. Roxy computes the answer, the agent interprets it into a natural response

Every reading is backed by real astronomical calculations, not hallucinated data.

Technical Details

Protocol

Implements MCP Specification 2025-11-25 (latest stable). Tools are auto-generated from our OpenAPI 3.1 spec.

Authentication

Pass your API key via X-API-Key header, Authorization: Bearer token, or api_key query parameter. Claude Messages API uses authorization_token which maps to Bearer auth.

Billing

MCP tool calls count against your monthly request quota. Tool discovery (listing endpoints) is free.

Supported platforms

Any MCP-compatible platform works. Verified with OpenAI Agents, Gemini Agents SDK, VS Code, GitHub Copilot, Claude Desktop, Windsurf, Cline, and custom agent frameworks.

Testing

Test endpoints in your browser using the MCP Inspector. Set transport to "Streamable HTTP", add your endpoint URL and X-API-Key header.

Multi-domain chatbot

Want all 8 domains in one chatbot? Clone the free Insight AI Chatbot. It uses MCP to auto-discover all Roxy tools and supports Gemini, Claude, and GPT. Production-ready in 30 minutes.