Engine MCP
The same 390+ calculators accessible as MCP tools.
The Engine MCP surface exposes the same 390+ calculators as MCP tools. Connect the endpoint to any MCP-aware AI assistant and it can discover all available calculators via tools/list and invoke them via tools/call.
MCP endpoint
https://engine.astrocodex.ai/v1/mcprest_mcpHow it works
- 1
Obtain an Engine API key (or use OAuth scope rest_mcp) from your account settings.
- 2
Register the MCP endpoint (https://engine.astrocodex.ai/v1/mcp) in your AI client and send your API key in an X-API-Key header (an OAuth Bearer token with the rest_mcp scope also works).
- 3
The AI calls tools/list to discover all available calculators and their input schemas.
- 4
The AI calls tools/call with the chosen calculator name and birth-data inputs to compute results.
- 5
Results are returned in structured JSON with localised name fields (pass lang in the request body if needed).
Good to know
MCP tools are addressed by their tool name from tools/list (e.g. calculate_yoga_engine), not by the dotted REST calculator name.
Plain-text output: add a top-level "format": "text" to the tools/call params (alongside name and arguments) to receive a ready-to-read text rendering instead of structured JSON.
Tradition tags: every tool description starts with a tag such as [VEDIC · sidereal zodiac] or [WESTERN · tropical zodiac], and _meta.system carries the same value — clients must never mix traditions in one reading.
Rate limits and monthly quotas apply per-plan, the same as the Engine REST API. The AI reasoning runs on your assistant's side and does not consume AstroCodex tokens.