Skip to content
MCP server

Cosine Astro MCP

Offline natal charts, transits, synastry and retrogrades for AI assistants

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Cosine Astro MCP

Cosine Astro MCP is a free MCP server for astrology. It runs locally on your machine and is started by your AI client.

Language models tend to guess where the planets were on a given date. This server does the arithmetic instead, computing positions locally from the astronomy-engine ephemeris and handing back both a compact text summary and the full data as JSON. It needs no API keys, makes no network calls and has no accounts.

It covers Western tropical astrology. A chart reports the ten planets with sign, degree, house and retrograde state, plus Ascendant, Midheaven, house cusps, aspects with orbs and element and modality balance. Birth data takes a local date, time, IANA timezone and coordinates, with historical daylight saving applied. Placidus houses are the default, with whole-sign used inside the polar circles.

If the birth time is unknown, planets are cast for local noon with no Ascendant or houses. A built-in table of about 110 large cities works as a shortcut; there is no geocoder, so other places need coordinates. It comes from COSINE, a birth-chart site, and uses the same engine.

Install

Run in a terminal

claude mcp add cosine-astro-mcp -- npx -y cosine-astro-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cosine-astro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cosine-astro-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cosine-astro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cosine-astro-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "cosine-astro-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cosine-astro-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "cosine-astro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cosine-astro-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "cosine-astro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cosine-astro-mcp"
      ]
    }
  }
}

Tools this server provides (6)

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

natal_chart
Computes a natal chart.
transits
Computes planet positions for a date and aspects to a natal chart.
synastry
Compares two charts.
mercury_retrograde
Finds Mercury retrograde periods in a date range.
annual_profection
Computes the annual profection for an age or date.
moon_phase
Reports the moon phase and upcoming principal phases.

What it does

Natal charts
Planets, angles, houses, aspects and element balance for a birth moment.
Transits
Current or chosen-date positions and their aspects to a natal chart.
Synastry
Cross aspects and house overlays between two charts.
Mercury retrograde
Retrograde periods with shadow dates and station degrees.
Annual profections
Profected house, sign and year lord for an age or date.
Moon phase
Phase, illumination and the next four principal moons.

Good for

  • Ask an assistant for an accurate natal chart instead of an estimate
  • Compare two people's charts for compatibility notes
  • Find Mercury retrograde dates inside a planning window
  • Check which house a transiting planet is in

Pricing

Free

No API keys or accounts needed

Prices change. Check cosineastro.com before you buy.

Cosine Astro MCP FAQ

Does it call any web service?

No. The README says it computes offline from the astronomy-engine ephemeris with no API keys or network calls.

What if I do not know the birth time?

Omit it; planets are cast for local noon and no Ascendant, Midheaven or houses are produced.

Which house systems exist?

Placidus by default or whole sign; whole sign is used automatically where Placidus has no solution.

What Node version is needed?

Node.js 20 or later.

Is Cosine Astro MCP free?

Yes. Cosine Astro MCP is free to use.

How do I add Cosine Astro MCP to Claude Code?

Run this command in your terminal: claude mcp add cosine-astro-mcp -- npx -y cosine-astro-mcp

What are the best alternatives to Cosine Astro MCP?

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

Alternatives to Cosine Astro MCP

  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