# Cosine Astro MCP

> Cosine Astro MCP is a free MCP server for astrology. Offline natal charts, transits, synastry and retrogrades for AI assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://www.cosineastro.com
- **Repository:** https://github.com/ganguoguo444004-coder/cosine-astro-mcp
- **MCP Registry name:** io.github.ganguoguo444004-coder/cosine-astro-mcp
- **Categories:** astrology
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [Céu Natal](https://ai-powered.com/mcp/ceu-natal): Céu Natal is an open-source MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/cosine-astro-mcp
