Skip to content
MCP server

Zodiac Compatibility

Zodiac sign matches, Sun, Moon, Venus and rising signs, and birth charts for AI clients

Pricing
Free
Platforms
Web, API
Runs
Remotely
Version
1.0.1
Listing updated
3 days ago

About Zodiac Compatibility

Zodiac Compatibility is a free MCP server for astrology. It runs as a hosted remote server, so there is nothing to install locally.

Beyond a basic match score, this server computes placements from real planet positions. Sun, Moon and Venus signs come from a birth date, with the Venus tool noting whether the planet was retrograde. The rising sign needs a date, time and place and also gives the Descendant, Midheaven and Imum Coeli.

A birth chart tool returns tropical placements with whole-sign houses, and a synastry tool lists up to ten of the tightest aspects between two charts with short meanings and a reading for a chosen kind of relationship. Sign matches give a verdict label, the wheel aspect and angle, elements and modalities, and one line each for love, friendship and work. Daily horoscopes are built from that day's planet positions and name the transits they use.

The hosted endpoint requires no key.

Install

Run in a terminal

claude mcp add --transport http zodiac-compatibility https://zodiaccompatibility.org/api/mcp

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "zodiac-compatibility": {
      "url": "https://zodiaccompatibility.org/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "zodiac-compatibility": {
      "type": "http",
      "url": "https://zodiaccompatibility.org/api/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "zodiac-compatibility": {
      "serverUrl": "https://zodiaccompatibility.org/api/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "zodiac-compatibility": {
      "type": "http",
      "url": "https://zodiaccompatibility.org/api/mcp"
    }
  }
}

Tools this server provides (9)

Read directly from the server.

check_sign_compatibility
Returns how two zodiac signs match: a verdict label, the wheel aspect and its angle, the elements and modalities, and one line each for love, friendship and work. Accepts two signs, or two birth dates whose Sun signs are read by month and day; a birthday near a sign change returns the possible pairs.
get_sign_profile
Returns a zodiac sign's dates, element, modality, ruler and polarity, its traits, how it behaves in love, friendship and work, and its compatibility verdict with all twelve signs, with the strongest matches named.
find_sun_sign
Returns the tropical Sun sign for a birth date. On a day the Sun changes sign it returns both possible signs, or the exact sign when a place and an optional birth time are given.
find_moon_sign
Returns the Moon's tropical zodiac sign for a birth date, with its degree when a birth time is given. Without a time it returns every sign the Moon visited that local date and when it changed sign.
find_rising_sign
Returns the rising sign (Ascendant) with its degree, and the Descendant, Midheaven and Imum Coeli signs, for a birth date, time and place. Notes when the Ascendant lies within 1.5 degrees of a sign boundary.
find_venus_sign
Returns the sign Venus was in on a birth date, with its degree and whether it was retrograde. A date on which Venus changed sign returns both signs unless a birth time is given.
get_birth_chart
Returns a tropical birth chart with whole-sign houses: the Sun, Moon and rising signs, each planet's sign, degree and house, the Ascendant and Midheaven, and up to ten of the tightest major aspects. Without a birth time the planets keep every sign possible that day and the houses and angles are omitted.
get_synastry
Returns up to ten of the tightest major aspects between two people's birth charts, each with a short meaning, and a reading for one relationship setting built from the planets that setting weighs. Each person is given by birth date, optional birth time and a place.
get_daily_horoscope
Returns a sign's reading for a UTC date, built from that day's real planet positions: the day's reading with the transits it uses, a one-line preview of the next day, and a line for each of the following seven days.

What it does

Sign compatibility
Gives a verdict, wheel aspect, angle and love, friendship and work notes.
Placement lookups
Finds Sun, Moon, Venus and rising signs from birth data.
Birth chart
Returns tropical placements with whole-sign houses.
Synastry
Lists the tightest aspects between two charts.
Daily horoscope
Built from the day's actual planet positions.

Good for

  • Compare two signs for love or work
  • Find a rising sign from birth time and place
  • See whether Venus was retrograde at birth
  • Compare two birth charts

Pricing

Free

Hosted endpoint, no key listed

Prices change. Check zodiaccompatibility.org before you buy.

Zodiac Compatibility FAQ

What do I need for the rising sign?

A birth date, time and place.

Which zodiac system is used?

Tropical, with whole-sign houses in the chart.

Are daily readings generic?

They are built from that day's real planet positions and list the transits used.

Does it need a key?

The registry entry lists no key.

Is Zodiac Compatibility free?

Yes. Zodiac Compatibility is free to use.

How do I add Zodiac Compatibility to Claude Code?

Run this command in your terminal: claude mcp add --transport http zodiac-compatibility https://zodiaccompatibility.org/api/mcp

What are the best alternatives to Zodiac Compatibility?

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

Alternatives to Zodiac Compatibility

  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