Birth charts & transits
calculate_natal · calculate_transits
read · mcp:charts · calculate:astrology
https://api.celestackapi.com/v1/mcp/charts
Connect an AI assistant to a focused six-tool profile. Calculate intentionally, then answer follow-up questions from saved results and immutable source facts.
Choose charts, Tarot or numerology. Each complete profile offers two queued calculations and four read tools: get_job, get_result, get_fact and get_usage. A read-only key exposes only the four read tools.
calculate_natal · calculate_transits
read · mcp:charts · calculate:astrology
https://api.celestackapi.com/v1/mcp/charts
draw_tarot · interpret_tarot
read · mcp:tarot · calculate:tarot
https://api.celestackapi.com/v1/mcp/tarot
calculate_numerology · compare_numerology
read · mcp:numerology · calculate:numerology
https://api.celestackapi.com/v1/mcp/numerology
Compute tools enqueue the existing API operations and use their published credit prices. Each intentional request supplies its own idempotency key. Follow-up reads use the saved operation ID and fact ID, so your assistant can cite the same calculated source instead of drawing or generating again.
The server checks the selected profile, key scopes and organization ownership on every call. Account, billing and AI-report creation are separate flows. This facade does not start them automatically.
command: python3
args: ["/your/path/celestack_mcp.py"]
env:
CELESTACK_API_KEY: <your dedicated secret>
CELESTACK_MCP_PROFILE: tarot
CELESTACK_API_URL: https://api.celestackapi.comKeep the secret in your MCP client’s private environment settings. The bridge supports legacy 2025-11-25 clients and modern 2026-07-28 requests. Hosted HTTP uses the stateless 2026-07-28 protocol with its required metadata headers.
Saved JSON lasts seven days. MCP tool results are bounded to 64 KiB; larger complete results use the authenticated REST saved-result endpoint. Poll jobs every 5–15 seconds. Existing credit, rate, queue and resource limits apply.