Cosine Astro MCP
Offline natal charts, transits, synastry and retrogrades for AI assistants
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"cosine-astro-mcp": {
"command": "npx",
"args": [
"-y",
"cosine-astro-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"cosine-astro-mcp": {
"command": "npx",
"args": [
"-y",
"cosine-astro-mcp"
]
}
}
}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
Natal Chart Lab
MCP serverKeyless MCP server for planet positions, retrogrades, Moon phases and birth placements
Runs locally- 5 tools
- Open source
- Astrology

Vedic astrology calculations for AI: kundli, guna milan, panchang, dosha and muhurat
- 10 tools
- Remote
- Free
- Astrology

AstroLogics
MCP serverVedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching
- 23 tools
- Remote
- Freemium
- Astrology

GenesisCore Astrology (Western + Vedic)
MCP serverFree Western and Vedic chart signs, retrogrades and ingresses from a date and place
- 4 tools
- Remote
- Free
- Astrology
Céu Natal
MCP serverSwiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese
- 9 tools
- Remote
- Open source
- Astrology

OIYO Korea Calculators
MCP serverDeterministic Korean tax, payroll, labor and calendar calculators served over MCP
- 76 tools
- Remote
- Free
- Finance and payments