Log inSubmit server
GetBirthChart MCP logo

GetBirthChart MCP

Calculates structured astrology charts through the GetBirthChart API over MCP stdio.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install GetBirthChart MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "getbirthchart-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@getbirthchart/mcp@0.2.0"
      ],
      "env": {
        "GETBIRTHCHART_API_KEY": "YOUR_VALUE_HERE",
        "GETBIRTHCHART_API_BASE_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @getbirthchart/mcp@0.2.0

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 15d ago.

Overview

GetBirthChart MCP MCP server exposes structured astrology calculations through the public GetBirthChart API. It runs as an MCP stdio process, reads a developer API key from its environment, and returns read-only calculation results. Use it for natal charts, planet positions, Moon and Rising signs, aspects, or synastry when preserving unknown-time limits and backend uncertainty matters. Inputs require coordinates and an IANA timezone; place labels are not geocoded.

Use cases

  • Calculate natal charts from structured birth data
  • Compare two birth charts with synastry calculations
  • Check planetary placements and natal aspects
  • Handle unknown birth times without inventing chart details

Key features

  • MCP stdio transport
  • Structured read-only astrology calculations
  • Unknown-time uncertainty preservation
  • Configurable natal calculation options
  • Structured error responses
  • Methodology and data-source resources

Tools7

What GetBirthChart MCP lets your agent do. Expand a tool for its parameters.

Self-reported~98 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

9/9 checks healthy over the last 53d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · @getbirthchart/mcp@0.2.0 (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads105Package downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed7Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How GetBirthChart MCP works

What GetBirthChart MCP MCP server does

GetBirthChart MCP MCP server connects MCP-compatible AI clients to the public GetBirthChart API for astrology calculations. The package does not implement or re-create the astrology engine; it forwards structured requests and exposes structured results as MCP tools. All tools are read-only.

The available operations cover natal charts, planetary placements, the Sun/Moon/Rising combination, Moon signs, Rising signs, natal aspects, and synastry between two people. Results preserve backend-owned facts and uncertainty. For example, an unknown birth time prevents the server from supplying houses or an Ascendant, and an uncertain Moon sign is returned as ambiguity rather than a forced selection.

How it works

The server accepts birth data containing a date and, when known, a time. Latitude, longitude, and an IANA timezone are required; place can be included as a label but is not resolved into coordinates. Set unknown_time when the time is unavailable and omit the time field. The server does not replace missing times with noon or invent a Rising sign.

get_rising_sign requires an exact birth time and returns birth_time_required otherwise. Synastry retains the unknown-time restrictions for each person separately. Calculation failures use structured error data with a machine-readable code, message, retryability, and sometimes a retry delay.

Natal requests can expose options such as house system, node type, aspect preset, custom aspect rules, additional points, zodiac, and ayanamsa. Sidereal calculations require a named ayanamsa. Synastry also accepts relationship-level settings including node convention and optional relationship metadata. The MCP contract exposes calculations, not interpretation; composite and Davison operations are not tools in this release.

Setup and configuration

Run GetBirthChart MCP MCP server with Node.js 20 or newer and a GetBirthChart developer API key. The package can be launched with npx using the @getbirthchart/mcp@0.2.0 package and an MCP host's command-based server configuration.

Set GETBIRTHCHART_API_KEY in the host environment. The key is read at startup, is not accepted as a tool argument, and is not written to protocol output, logs, resources, or tool results. GETBIRTHCHART_API_BASE_URL is optional for development or testing. HTTPS is required except for localhost HTTP use; do not send a production key to an untrusted endpoint.

The package does not persist, cache, or log birth inputs and has no analytics or telemetry. It also provides three resources: methodology, data-source provenance, and engine information.

Tools and capabilities

  • calculate_birth_chart returns a mapped natal chart and omits houses and the Ascendant when the time is unknown.
  • get_planet_positions returns planetary placements while retaining chart uncertainty.
  • get_big_three returns the Sun, Moon, and an optional Rising sign without guessing.
  • get_moon_sign reports the Moon sign or ambiguity when one sign cannot be established.
  • get_rising_sign returns the Rising sign only when an exact time is available.
  • calculate_aspects returns natal aspects based on backend-owned facts.
  • calculate_synastry compares two people while preserving each person's time-related limits.

GetBirthChart MCP MCP server is suited to agents that need machine-readable calculation data rather than prose interpretations. Common API errors include validation, authentication, location, rate-limit, timeout, and internal failures.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about GetBirthChart MCP

GetBirthChart MCP is an MCP server that connects AI clients to the public GetBirthChart API for structured astrology calculations. Its main tools calculate birth charts, planetary positions, big-three results, Moon and Rising signs, natal aspects, and synastry while preserving uncertainty instead of inventing missing birth-time information.

Install it by configuring your MCP host to run Node.js 20 or newer with `npx -y @getbirthchart/mcp@0.2.0`. Add `GETBIRTHCHART_API_KEY` to the server environment and obtain the key from the GetBirthChart developer hub.

The required variable is `GETBIRTHCHART_API_KEY`. Set it in the MCP host's server environment; the key is read at startup and must not be passed in tool calls. `GETBIRTHCHART_API_BASE_URL` is an optional endpoint override for development or testing.

It preserves uncertainty and does not guess. Set `unknown_time` to true and omit `time`; chart results omit the Ascendant and houses, Rising-sign requests return `birth_time_required`, and Moon results can remain ambiguous.

It requires numeric WGS84 latitude, longitude, and an IANA timezone. A `place` value is only a label because the current public API does not geocode locations.

Related MCP servers

All in Spirituality & Esoterica All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGetBirthChart MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/getbirthchart-mcp?style=directory)](https://allmcps.com/mcp/getbirthchart-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/getbirthchart-mcp"><img src="https://allmcps.com/api/badge/getbirthchart-mcp?style=directory" alt="GetBirthChart MCP on AllMCPs" /></a>