Skip to content
Occult API

Claude Code

Connect Claude Code to Occult API for natural language astrology queries.

Prerequisites

An Occult API key from the dashboard, Claude Code installed.

Setup

Add your Occult API key as an environment variable. Claude Code can use it when making API calls. Use the MCP server at /mcp for automatic endpoint discovery.

Set API Key
export OCCULT_API_KEY="your_api_key_here"

Usage

Ask Claude Code to generate astrology API calls using natural language. For example, you can ask it to generate a natal chart calculation:

Natal Chart
curl -X POST https://api.occultapi.com/api/astro/chart/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time": "1990-05-15T14:30:00+05:30", "latitude": 28.6139, "longitude": 77.209, "timezone_as_float": 5.5}'

Tips

Use Claude Code's tool use to have it automatically search Occult API endpoints before making calls.