MCP Server

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect to external tools. By adding the NatalEngine MCP server, Claude can calculate birth charts on demand.

Quick Start

Option 1: Install from npm

npm install -g natalengine

Add to your Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "natalengine": {
      "command": "npx",
      "args": ["natalengine-mcp"]
    }
  }
}

Option 2: Clone from source

git clone https://github.com/Unforced-Dev/natal-engine.git
cd natalengine
npm install

Add to settings:

{
  "mcpServers": {
    "natalengine": {
      "command": "node",
      "args": ["/path/to/natalengine/src/mcp/index.js"]
    }
  }
}

Try It

Restart Claude Code and ask:

"Calculate my birth chart for June 15, 1990 at 2:30 PM in New York"

Available Tools

calculate_natal_chart

Complete profile from all four systems (Western astrology, Vedic, Human Design, Gene Keys).

calculate_astrology

Western natal chart with planets, aspects, and analysis.

calculate_vedic

Vedic (Jyotish) chart with Lahiri ayanamsa, Nakshatras, and Vimshottari Dasha.

calculate_human_design

Type, Strategy, Authority, Profile, Gates, Channels.

calculate_gene_keys

Activation, Venus, and Pearl sequences with shadow/gift/siddhi.

get_planetary_positions

Raw astronomical data for all celestial bodies.

Example Prompts

• "What's my Human Design type if I was born March 21, 1985 at 6 AM in LA?"
• "Calculate the Gene Keys for December 25, 1992 at 11:30 PM in London"
• "Show me the aspects for August 15, 1988, 3:30 PM, Tokyo"
• "What's my Vedic moon sign and nakshatra for February 14, 1990, 8 AM in Mumbai?"
• "What are the planetary positions for July 4, 1976 at noon in Philadelphia?"

All Local

All calculations run on your machine. No birth data is sent to external servers. The MCP server uses the same astronomy-engine library as the web calculator for high-precision results.

Troubleshooting

Server not found

Check the path in settings.json. For npx, ensure natalengine is installed globally.

Tools not appearing

Restart Claude Code. Verify the server works:

npx natalengine-mcp
# Should output: "NatalEngine MCP Server running on stdio"

Calculation errors

Dates must be YYYY-MM-DD format. Times must be 24-hour HH:MM format.