RoxyAPI agent plugin for Claude Code and Cursor

License: MIT

A Claude Code and Cursor plugin that teaches your coding agent how to build on RoxyAPI, the multi domain spiritual intelligence API: Western and Vedic astrology, horoscopes, forecast, human design, Chinese astrology, feng shui, Mesoamerican astrology, Vastu, numerology, Kabbalah, tarot, biorhythm, Ayurveda, I Ching, crystals, dreams, angel numbers, and location. One key, every domain. Remote MCP, typed SDKs, and drop in UI components live alongside at roxyapi.com.

One install gives the agent two things, no API key required:

A Skill that tells the agent when and how to call RoxyAPI: the location first rule, X-API-Key auth, endpoints per domain, the error contract, and the SDK and Remote MCP integration paths.
The keyless Docs MCP (search_docs), auto connected, so the agent looks up the exact endpoint, field, or SDK method live from the reference instead of guessing.

Both stay current automatically. The plugin is regenerated from the live OpenAPI spec and the published agent playbook, so as the API grows the Skill grows with it.

Install in Claude Code

/plugin marketplace add RoxyAPI/agent-plugin
/plugin install roxyapi@roxyapi

Install in Cursor

Clone the plugin into the local plugins folder, then reload Cursor:

git clone https://github.com/RoxyAPI/agent-plugin ~/.cursor/plugins/local/roxyapi

Cursor loads the same Skill and connects the same keyless Docs MCP.

Any Agent Plugins client

The repository root is a standard Agent Plugins package: plugin.json, skills/, and mcp.json. Any client that loads that open format gets the same Skill and Docs MCP from this repository URL.

That is the whole setup. The agent now reaches for RoxyAPI when you build any astrology, tarot, numerology, human design, forecast, or other insight feature, and can query the Docs MCP for exact endpoints while it writes the integration.

Make live API calls

The Docs MCP is keyless and answers questions about the API. To let the agent call the API for real (returning live charts, readings, or forecasts), add a per domain Remote MCP server with your key. Get a key at roxyapi.com/account, then add to your MCP config:

{
  "mcpServers": {
    "roxy-astrology": {
      "type": "http",
      "url": "https://roxyapi.com/mcp/astrology",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}

Swap astrology for any domain. See the MCP guide.

Remote MCP servers

Every domain is its own Streamable HTTP server at https://roxyapi.com/mcp/{domain}. They are hosted, so there is nothing to install, build, or run locally: point an MCP client at the URL and the tools are discovered on connect. Each one is listed and live tested on Glama:

· · · · · · · · · · · · · · · · · ·

This repository is the Claude Code and Cursor plugin, not one of those servers. It carries no MCP server of its own to install: it connects the editor to the hosted ones above and ships the Skill that teaches the agent how to use them.

What is RoxyAPI

Hosted infrastructure for insight, prediction, and spiritual intelligence apps. One subscription, one API key, every domain. Calculations are powered by Roxy Ephemeris, verified against NASA JPL Horizons. Flat pricing, no AGPL, instant key delivery, typed SDKs for TypeScript, Python, PHP, C#, and Go, and Remote MCP across every domain. See the methodology.

License

MIT. See LICENSE.

RoxyAPI agent plugin for Claude Code and Cursor