@getbirthchart/mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GETBIRTHCHART_API_KEY | Yes | Server-side developer API key. Create a key at getbirthchart.com/developers. Required at startup. | |
| GETBIRTHCHART_API_BASE_URL | No | HTTPS API base URL override for development/testing. HTTP is accepted only for localhost. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| calculate_birth_chartA | Calculate structured natal chart data from birth information. When birth time is unknown, preserve that uncertainty and omit time-dependent results such as the Ascendant and houses rather than assuming a default time. |
| get_planet_positionsC | Calculate planetary positions for a birth date and optional exact birth time and location. Returns structured placements supported by GetBirthChart. |
| get_big_threeA | Calculate the Sun, Moon, and Ascendant for a birth chart. If birth time is unknown, do not guess the Ascendant; return it as unavailable according to the GetBirthChart contract. |
| get_moon_signA | Calculate the Moon sign while preserving uncertainty when the Moon may have changed zodiac signs during a date with unknown birth time. |
| get_rising_signA | Calculate the Ascendant (Rising sign) from birth date, exact birth time, and location. An exact birth time is required; never infer or guess a Rising sign. |
| calculate_aspectsA | Calculate structured natal aspects between chart bodies using GetBirthChart's calculation methodology. Returns factual aspect data without interpretation. |
| calculate_synastryA | Calculate structured synastry relationships between two birth charts. Returns factual inter-chart data without compatibility scores or relationship conclusions. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| methodology | Authoritative calculation-method context for GetBirthChart results. |
| data-sources | Source provenance and location/timezone input boundaries. |
| engine-info | Technical metadata about the GetBirthChart calculation provider. |
TDQS
Scored across 7 tools
The tools are generally clear but overlap exists: calculate_birth_chart likely subsumes get_planet_positions, get_big_three, get_moon_sign, get_rising_sign, and calculate_aspects. Descriptions help distinguish full-chart vs. granular lookups, but an agent could misselect when a broad chart request overlaps with a specific placement request.
All tool names follow a consistent verb_noun pattern with snake_case throughout. The get_ prefix is used for direct placement lookups and calculate_ for computed chart outputs, which is a predictable and recognizable convention.
Seven tools is well-scoped for an astrology calculation API: a full chart, key placements, aspects, and synastry. Each tool serves a distinct calculation need and the count feels neither bloated nor thin.
The server covers the core birth-chart workflows: full chart, planetary positions, Sun/Moon/Rising, aspects, and synastry. Minor gaps exist such as no dedicated Sun-sign or house-position endpoint, but calculate_birth_chart covers those cases and avoids dead ends.