CALCULATED FACTS FOR YOUR ASSISTANT

A smaller toolset.
A clearer answer.

Connect an AI assistant to a focused six-tool profile. Calculate intentionally, then answer follow-up questions from saved results and immutable source facts.

One profile. Six stable tools.

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.

CHARTS

Birth charts & transits

calculate_natal · calculate_transits

read · mcp:charts · calculate:astrology

https://api.celestackapi.com/v1/mcp/charts

TAROT

Drawn or selected cards

draw_tarot · interpret_tarot

read · mcp:tarot · calculate:tarot

https://api.celestackapi.com/v1/mcp/tarot

NUMEROLOGY

Transparent number profiles

calculate_numerology · compare_numerology

read · mcp:numerology · calculate:numerology

https://api.celestackapi.com/v1/mcp/numerology

Keep the source, continue the conversation.

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.

Use it with your MCP client.

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.com

Keep 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.

Predictable limits.

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.