MCP SERVER

Tools exposed

• calculate_transits

  Planetary transit aspects for a natal chart over a date range. Returns enter/exact/exit dates, positions, orbs.

• calculate_electional_spellcasting

  Ranked electional windows for any of 72 intents. Returns top windows with pass-level scores + rationale.

• calculate_solar_return

  Annual solar return chart + profection + lord of year. Returns SR placements, houses, and per-category scores.

• calculate_timeline_full_report

  Paid exact-time Timeline report. Returns raw dated-event, profection, eclipse, and long-range timing JSON.

• calculate_month_forecast

  Paid exact-time Month Ahead report. Returns daily intensity, peak windows, confidence-ranked domains, timing spine, and generated narrative JSON.

• calculate_vedic_chart

  Paid exact-time Vedic Chart report. Returns Western tropical, Tropical Vedic, sidereal Vedic, dasha, nakshatra, and varga JSON.

Quick install — Claude Desktop

Add this block to claude_desktop_config.json:

{
  "mcpServers": {
    "electional": {
      "command": "npx",
      "args": ["tsx", "/path/to/transits/src/mcp/index.ts"],
      "env": {
        "TRANSITS_API_URL": "https://electional.io",
        "TRANSITS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. The tools appear in the tools panel. Ask Claude something like "What are the best electional windows for launching a business in the next 60 days for my chart?" and it'll call the MCP server.

Get an API key

The MCP server is a thin client over Electional's REST API. You need an API key to use it.

1. Sign up for an account (free, includes 10 starter credits).
2. Subscribe to Builder API ($49/30 days, 250 credits) or Studio API ($149/30 days, 1000 credits) for ongoing usage, or use top-ups.
3. Generate a key at /api-keys.

Example: ask Claude

You: When are the strongest windows for me to launch a new
     business in the next 60 days? I'm born 1990-06-15 at
     14:30 in New York.

Claude: [calls calculate_electional_spellcasting with
        intentId: "career-advancement-promotion", birthDate,
        birthTime, locationQuery, rangeDays: 60]

Claude: Top 3 windows:
  1. 2026-06-12 09:14 EDT — PRIME (76%)
     Sun trine natal Jupiter, Moon in 10th, Mercury angular...
  2. 2026-06-28 11:05 EDT — STRONG (62%)
     ...
  3. ...

Credit cost

• calculate_transits - 1 credit (+1 if transitToTransit enabled)
• calculate_electional_spellcasting - 1 credit per 30 days scanned
• calculate_solar_return - 1 credit
• calculate_timeline_full_report - 3 credits
• calculate_month_forecast - 5 credits
• calculate_vedic_chart - 3 credits

FAQ

• What is MCP?

  Model Context Protocol (MCP) is an open standard from Anthropic that lets AI assistants call external tools through a uniform interface. An MCP server exposes one or more tools that any MCP-compatible agent (Claude Desktop, custom GPTs with MCP, agent frameworks) can invoke.

• What tools does the Electional MCP server expose?

  Six tools: calculate_transits, calculate_electional_spellcasting, calculate_solar_return, calculate_timeline_full_report, calculate_month_forecast, and calculate_vedic_chart.

• Does using the MCP server consume API credits?

  Yes. The MCP server is a thin client that calls Electional's REST API on your behalf. Same credit cost as direct API calls. You need a TRANSITS_API_KEY environment variable.

• How do I install it in Claude Desktop?

  Add the Electional server block to your claude_desktop_config.json with your API key. Full config snippet below.

• Can I use it from ChatGPT custom GPTs?

  MCP support is coming to GPT actions. For now, ChatGPT custom GPTs can call the REST API directly — same endpoints, no MCP needed.

• Is the source available?

  The MCP server source lives in the Electional repo at src/mcp/index.ts. Not currently published as a standalone package — install by cloning the repo or by pointing your MCP config at npx tsx with the file path.