Skip to content
MCP server

AstroProcessor

Lets AI assistants read your natal chart and forecasts from exact ephemeris data

Pricing
Freemium
Platforms
Web, API
Runs
Remotely
Version
1.0.1
Listing updated
2 days ago

About AstroProcessor

AstroProcessor is a freemium MCP server for astrology. It runs as a hosted remote server, so there is nothing to install locally.

Language models tend to estimate planet positions from text they have read, which can get a degree, sign or house wrong. This connector has the assistant call AstroProcessor's own chart engine instead, which uses NASA/JPL-grade ephemeris data, and read the numbers back.

You sign in with your AstroProcessor account in the browser during setup, so no API key is copied. The tools cover your natal chart, four forecast techniques (directions, transits, solar return and progressions), lunar returns, relocation, synastry, AstroMap city searches, horary charts, moon and eclipse data and sunrise times. Paid plans additionally let the assistant read your other saved charts and cast horary charts.

The connector writes one thing only: your birth data and natal chart, once, if your profile has none. It never edits or deletes charts and never reads chat threads or notes.

Install

Run in a terminal

claude mcp add --transport http astroprocessor https://mcp.astroprocessor.app/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.astroprocessor.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "astroprocessor": {
      "url": "https://mcp.astroprocessor.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "astroprocessor": {
      "type": "http",
      "url": "https://mcp.astroprocessor.app/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "astroprocessor": {
      "serverUrl": "https://mcp.astroprocessor.app/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "astroprocessor": {
      "type": "http",
      "url": "https://mcp.astroprocessor.app/mcp"
    }
  }
}

Tools this server provides (16)

Taken from the project documentation; the running server may differ.

get_chart_data
Your natal chart from the birth data in your profile.
list_charts
Saved charts and horary questions by name.
get_directions
Symbolic directions against the natal chart.
get_transits
Transits for a date with exact-pass dates.
get_solar_return
Solar return for the year in force.
get_progressions
Secondary progressions for a date.
get_relocation_place
Natal chart recast for another city.
get_synastry
Comparison with another person's chart.
get_lunar_return
Lunar return for the current or next month.
search_astromap_cities
Cities near chosen AstroMap lines.
get_horary_chart
Horary chart for a question.
get_moon_data
Moon sign, phase and next phase times.
find_eclipse
Next or previous solar and lunar eclipses.
get_sunrise_sunset
Sunrise and sunset for a day and place.
find_city
Matches city names with time zones.
get_balance
Your plan and balance.

What it does

Exact natal chart
Returns planets with sign, degree, house and dignity, plus angles and aspects.
Four forecast tools
Directions, transits, solar return and progressions, each with the dates of exact contacts.
Relocation and AstroMap
Recasts a chart for another city and finds cities near your AstroMap lines.
Synastry
Compares your chart with another person's from a birth date, time and city you give.
Horary charts
Casts a chart for a question you ask now or one you saved (paid plans).
Sky data
Moon phase, eclipses, sunrise and sunset, and city lookup with time zones.

Good for

  • Ask which house your Moon is in and get a computed answer
  • Look at transits and directions for the coming year
  • See how your chart would change if you lived in another city
  • Compare two birth charts for compatibility
  • Cast a horary chart for a question you have now

Pricing

Freemium

Free account with a daily message allowance; Start 5 EUR/month, Pro 10 EUR/month, Lifetime 50 EUR once

Prices change. Check astroprocessor.app before you buy.

AstroProcessor FAQ

Which AI apps work with it?

ChatGPT as a custom MCP server (depending on plan), Claude as a custom connector, Claude Code and Gemini CLI with one command, and any client that supports Streamable HTTP with OAuth.

Is there an API key?

No. You sign in with your AstroProcessor account in the browser.

Can the assistant see my saved charts?

Yes on a paid plan, if you tick the consent box when connecting. It can read natal and horary charts by name.

What does it cost?

Free accounts can use it within a daily message allowance for their own natal chart. Start is 5 EUR a month, Pro 10 EUR, and Lifetime 50 EUR once, all with unlimited connector use.

Is it in the official MCP registry?

Yes, as app.astroprocessor/astroprocessor.

Is AstroProcessor free?

AstroProcessor has a free plan, with paid plans for more usage or features.

How do I add AstroProcessor to Claude Code?

Run this command in your terminal: claude mcp add --transport http astroprocessor https://mcp.astroprocessor.app/mcp

What are the best alternatives to AstroProcessor?

The closest alternatives to AstroProcessor are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.

Alternatives to AstroProcessor

  1. Natal Chart Lab

    MCP server

    Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements

    Runs locally
    • 5 tools
    • Open source
    • Astrology
  2. AstroLogics

    MCP server

    Vedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching

    • 23 tools
    • Remote
    • Freemium
    • Astrology
  3. Céu Natal

    MCP server

    Swiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese

    • 9 tools
    • Remote
    • Open source
    • Astrology
  4. Deterministic Korean tax, payroll, labor and calendar calculators served over MCP

    • 76 tools
    • Remote
    • Free
    • Finance and payments