GetBirthChart MCP server

by getbirthchart-com·io.github.getbirthchart-com/getbirthchart-mcp·v0.1.1

No reviews yet

Official MCP server for GetBirthChart astrology calculations.

B77/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B77/100

full report

Adoption

New

0 stars20 downloads/wk

Reviews

Write one

Nobody has reviewed GetBirthChart MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

GetBirthChart MCP tools (7)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

calculate_aspects
calculate_birth_chart
calculate_synastry
get_big_three
get_moon_sign
get_planet_positions
get_rising_sign

Public scan report

scanner v0.1.10 · 2026-10-30 · same rubric, same numbers if you re-run it

no findings

Code scan6 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 60 days ago12/15
Maintainer identityregistry namespace matches repository owner7/10

Overall 77/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How GetBirthChart MCP compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 77/100; higher than 50% of 48,243 servers
Tools: 7; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 20; more than 7% of 12,306 servers with a package

What its tools let an agent do: 7 read

Install GetBirthChart MCP in Claude Code, Cursor or VS Code

Runs npx -y @getbirthchart/mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add getbirthchart-mcp -- npx -y @getbirthchart/mcp

Add to Cursor

What the publisher says

From the GetBirthChart MCP repository's README, as published. We do not edit it. Read it on GitHub

@getbirthchart/mcp

Official MCP server 0.2.0 for GetBirthChart astrology calculations. It gives MCP-compatible AI clients access to structured calculations through the public GetBirthChart API; it does not contain or reimplement the astrology engine.

Requirements

Node.js 20 or newer
A GetBirthChart developer API key

Create a key at getbirthchart.com/developers. Keep it private and do not commit MCP host configuration containing the real key.

Quick start

The package runs over MCP stdio and can be launched with npx:

{
  "mcpServers": {
    "getbirthchart": {
      "command": "npx",
      "args": ["-y", "@getbirthchart/mcp@0.2.0"],
      "env": {
        "GETBIRTHCHART_API_KEY": "gbc_live_your_key_here"
      }
    }
  }
}

This is the standard command-based configuration for hosts that support MCP stdio servers. Use your client’s current documentation for the exact configuration file or UI location; this repository has been protocol-tested with the official MCP TypeScript client, not vendor-specific clients.

Environment variables

The key is read at startup, never accepted as a tool argument, and never written to stdout, logs, resources, or tool results.

Available tools

All tools are read-only and return structured calculation facts. Inputs use strict fields: date, optional time and place, required latitude, longitude, and timezone, plus optional unknown_time and calculation settings documented below.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

GetBirthChart MCP: common questions

Is GetBirthChart MCP server safe?: Mostly: it is graded B (77/100). Read the GetBirthChart MCP safety report
How do I install GetBirthChart MCP?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does GetBirthChart MCP need an API key?: Yes. The registry entry asks for GETBIRTHCHART_API_KEY.
Is GetBirthChart MCP maintained?: The last commit was 66 days ago (2026-08-31). The latest release is v0.1.1.
How does GetBirthChart MCP compare with other MCP servers?: safety score 77/100 (higher than 50% of 48,243 servers); tools 7 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.