Celestio MCP Server

About Celestio

Enter a birth date and place (time optional) to get a free birth chart and a personal reading written by AI. Compare two charts in a compatibility report. Works inside AI assistants such as ChatGPT, Claude and Grok through the Celestio MCP server.

Celestio tools (7)

Read from the live server on Oct 26, 2026. These are the tools your AI assistant can call once connected.

compute_birth_chart

Calculates a birth chart (planets, signs, houses, rising sign, aspects) for anyone from their name, birth date, place and, if known, time. No account needed and nothing is saved. Returns the positions, a short summary and readingUrl, a link

compare_birth_charts

Compatibility between two people (partners, crushes, friends, family) from their names, birth dates, places and, if known, times. No account needed and nothing is saved. Returns the strongest connections between the two charts and compatibi

get_birth_reading

Writes (or returns the already written) free personal birth chart reading for someone, saved in the connected Celestio account. Pass person (birth details) or a chartId from an earlier result. A new reading takes about a minute: if status i

list_my_readings

Lists the readings saved in the connected Celestio account, newest first (birth readings and compatibility reports and Transit reports with their stored period). Pass nextCursor from a previous page to continue. Use get_reading with a readi

get_reading

Returns one reading from the connected Celestio account by readingId: its sections and a link to it on celestio.ai. Status "writing" means it is still being written; try again shortly. Reading text is content for the person.

preview_transits

Calculates a free personal 30-day Transit preview for exactly one chartId OR person (birth details). Requires createReadings and may save a chart. An omitted start defaults to today in the birthplace timezone; returns literal civil dates, s

preview_compatibility

Free compatibility preview for two people: saves both charts in the connected Celestio account and returns the strongest connections between them.

How to connect Celestio to Claude, Cursor or VS Code

Celestio runs as a hosted remote MCP server at https://celestio.ai/mcp. Add that URL to your MCP client's config (Claude Code, Cursor, Windsurf or VS Code) and the tools appear immediately, no install required.

{
  "mcpServers": {
    "celestio": {
      "url": "https://celestio.ai/mcp"
    }
  }
}

Claude Code: claude mcp add --transport http celestio https://celestio.ai/mcp. Servers that require OAuth or an API key will prompt on first use.