MCP Server

Use GitStrology from any Model Context Protocol compatible client (Claude Desktop, Cursor, etc.) via the official MCP server.

Install

npm install -g @gitstrology/mcp-server

Configure

Add the server to your MCP client config. For Claude Desktop, edit~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on your platform:

{
  "mcpServers": {
    "gitstrology": {
      "command": "npx",
      "args": ["-y", "@gitstrology/mcp-server"],
      "env": {
        "GITSTROLOGY_API_KEY": "gs_live_..."
      }
    }
  }
}

Available tools

Once connected, the client can call any of these tools:

Tool	Description
`natal_chart`	Generate a natal chart.
`horoscope`	Daily horoscope for a sign.
`compatibility`	Synastry between two people.
`transits`	Current transits for a chart.
`tarot`	Draw a tarot spread.
`numerology`	Numerology reading for a name.
`moon_phase`	Moon phase for a date.
`sun_sign`	Sun sign for a birth date.

The server uses your GITSTROLOGY_API_KEY and consumes the same credits as the REST API — see rate limits & credits.