Model Context Protocol

Put astrology tools inside your AI assistant

Our MCP server exposes every endpoint in the REST catalogue as a tool your assistant can call directly. Calculate charts from the chat window, without writing code.

What is MCP?

The Model Context Protocol is an open standard that lets AI clients use external services through a common interface. Once you register our server, your assistant discovers on its own which tools exist, what parameters they expect and what they return.

  • Same key, same credits MCP calls use exactly the same SKUs and credit costs as REST — there is no separate billing.
  • Schema discovery built in Each tool publishes its own input schema, so the assistant fills in the right parameters itself.
  • Client agnostic Works with any MCP-capable client; configuration for the three most common ones is below.
Server URL https://www.astrowise.io/mcp
Authentication Authorization: Bearer ab_live_…
Transport HTTP (streamable)

MCP access is available on the Professional and Enterprise plans. Create your key in the API panel at www.astrowise.io/api-panel and substitute it in the examples here.

Go to the API panel

Connection setup

Add the configuration below to your client's settings file and drop in your own key.

claude_desktop_config.json

Claude Desktop

Add it to the config file under Settings > Developer > Edit Config.

{
  "mcpServers": {
    "astro-bilge": {
      "type": "http",
      "url": "https://www.astrowise.io/mcp",
      "headers": {
        "Authorization": "Bearer ab_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
bash

Claude Code

Add it with a single terminal command; the configuration is saved automatically.

claude mcp add --transport http astro-bilge https://www.astrowise.io/mcp \
  --header "Authorization: Bearer ab_live_xxxxxxxxxxxxxxxxxxxxxxxx"
.cursor/mcp.json

Cursor

Create .cursor/mcp.json in your project root and paste it in.

{
  "mcpServers": {
    "astro-bilge": {
      "type": "http",
      "url": "https://www.astrowise.io/mcp",
      "headers": {
        "Authorization": "Bearer ab_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Restart the client after saving the configuration and the tools will appear in the tool list.

Available tools

Every SKU in the REST catalogue is exposed as an MCP tool with the same name.

natal_chart 1 credits
Natal Chart

Produces planet, house and aspect data from a birth date, time and location.

transits 1 credits
Transit Chart

Returns the aspects the sky forms with the natal chart on a chosen date.

solar_return_chart 1 credits
Solar Return

Calculates the annual chart for the moment the Sun returns to its natal degree.

horary_chart 1 credits
Horary Chart

Returns the horary chart for the moment of the question plus validity checks.

synastry_chart 2 credits
Synastry

Extracts inter-chart aspects and house overlays between two charts.

composite_chart 2 credits
Composite Chart

Builds a relationship chart from the midpoints of two charts.

electional_search 3 credits
Electional Timing

Scores and ranks the most favourable moments for a purpose within a date range.

lunar_phases 3 credits
Lunar Phases

Produces a lunar cycle calendar including new moons, full moons and eclipses.

natal_interpretation 20 credits
Natal Interpretation (AI)

Turns natal chart data into a sectioned, natural-language interpretation.

account_usage Free
Account Info

Returns your active plan, remaining monthly quota and credit balance.

Give your assistant astrology skills

Upgrade to Professional in the API panel, grab your key and get going with a few lines of configuration.

Go to the API panel Browse plans Documentation