FreeAstroAPI Astrology

Western, Vedic, and Chinese astrology calculations, charts, forecasts, and geocoding over hosted MCP.

Connect FreeAstroAPI directly to AI tools through a hosted MCP server. You do not need to install a local server, run a script, or build anything first. Add one URL, add your API key, reconnect your AI tool, and it can start calling astrology endpoints as tools.

Best for AI-first users:if your app offers “Remote MCP”, “Hosted MCP”, or “Streamable HTTP MCP”, choose that option. If it only asks you for a terminal command, that app is expecting a local stdio server instead.

Claude Desktop's Custom Connector form cannot add thex-api-keyheader. Install this desktop extension instead. It asks for your FreeAstroAPI key during setup and requires no terminal commands.

/downloads/mcp/freeastroapi-claude-desktop.dxt
- Download the extension file.
- Open Claude Desktop → Settings → Extensions → Advanced settings.
- Choose Install Extension and select the downloaded file.
- Paste your API key, then enable FreeAstroAPI under Search and tools.

In your AI app, create a new remote MCP server and paste the URL from this page.

Send your key as thex-api-keyheader. The MCP server uses the same key and limits as the normal API.

Once connected, your AI can discover tools and call them directly instead of guessing astrology data.

Name: FreeAstroAPI Type: Remote / Hosted MCP server URL: https://api.freeastroapi.com/mcp Header: x-api-key: YOUR_API_KEY

- City Search
- Moon Phase
- Moon Phase Timeline
- Ephemeris
- Daily horoscope endpoints

- Natal chart calculation
- Transits
- Western synastry
- Vedic chart endpoints
- Chinese BaZi endpoints

Authentication, billing, admin, webhooks, and account-management endpoints are intentionally excluded from MCP.

Search Paris, France and give me the exact timezone and coordinates.

Calculate a natal chart for June 1, 1990 at 14:30 in New York.

Show me the current moon phase and explain it in simple language.

Get a weekly ephemeris table for Venus and Mars in tropical zodiac.

Most users will never need this. It is here for advanced tools, testing, and debugging.

curl -X POST "https://api.freeastroapi.com/mcp" \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-03-26", "capabilities": {}, "clientInfo": { "name": "example-client", "version": "1.0.0" } } }'

curl -X POST "https://api.freeastroapi.com/mcp" \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "v2_geo_search", "arguments": { "q": "paris", "limit": 3 } } }'

{ "jsonrpc": "2.0", "id": 2, "result": { "content": [ { "type": "text", "text": "{\n \"results\": [ ... ],\n \"count\": 3\n}" } ], "structuredContent": { "results": [ { "name": "Paris", "country": "FR", "lat": 48.85341, "lng": 2.3488, "timezone": "Europe/Paris", "population": 2138551 } ], "count": 1 }, "metadata": { "status_code": 200, "path": "/api/v2/geo/search", "method": "GET" } } }

Claude Desktop's Custom Connector rejects this setup.Download the Claude Desktop extension above. The URL-only connector form cannot send the requiredx-api-keyheader.

I only see “command” setup, not URL setup.That app expects a local stdio MCP server. Use an app that supports remote or hosted MCP.

The server connects but tools fail.Check that your API key is valid and has not expired. MCP uses the same key and limits as the normal API.

My AI says rate limited.MCP calls count exactly like direct API requests. CheckRate Limits.

Search Apple's Developer Documentation with smart search and wildcard support.