Quickstart

Get a key and make your first call in under five minutes.

1. Get a key

Free tier, no card — the key is emailed to you:

curl -X POST https://mysticapi.com/v1/keys/free \
  -H "content-type: application/json" \
  -d '{"email":"you@example.com"}'

Paid tiers (flat monthly, key emailed after checkout): Maker $19, Pro $49, Scale $149.

2. Make a call

Send the key as a bearer token. A bodygraph from a UTC birth instant:

curl -X POST https://mysticapi.com/v1/bodygraph \
  -H "Authorization: Bearer mk_live_..." \
  -H "content-type: application/json" \
  -d '{"year":1990,"month":3,"day":15,"hour":12,"minute":30}'
# -> { "chart": { ...type, authority, profile, channels, centers... }, "svg": "" }

Today’s universal sky (no birth data):

curl -H "Authorization: Bearer mk_live_..." https://mysticapi.com/v1/sky/today

A personal-sky SVG (drops straight into an <img>):

curl -H "Authorization: Bearer mk_live_..." \
  "https://mysticapi.com/v1/sky/personal?year=1990&month=3&day=15&hour=12&minute=30"

3. Or connect an agent (MCP)

MysticAPI is a remote MCP server. Add it to an MCP client:

claude mcp add --transport http mysticapi https://mysticapi.com/mcp \
  --header "Authorization: Bearer mk_live_..."

Tools: sky_today, bodygraph, sky_personal, ephemeris, numerology, relationship. Or pay per call with x402 and no account.

More endpoints

# Raw positions for any instant
curl -H "Authorization: Bearer mk_live_..." \
  "https://mysticapi.com/v1/ephemeris?year=1990&month=3&day=15&hour=12&minute=30"

# Numerology profile
curl -X POST https://mysticapi.com/v1/numerology \
  -H "Authorization: Bearer mk_live_..." -H "content-type: application/json" \
  -d '{"year":1990,"month":3,"day":15,"hour":12,"minute":30}'

# Relationship composite (two people)
curl -X POST https://mysticapi.com/v1/relationship \
  -H "Authorization: Bearer mk_live_..." -H "content-type: application/json" \
  -d '{"personA":{"year":1979,"month":8,"day":5,"hour":22,"minute":51},
       "personB":{"year":1990,"month":3,"day":15,"hour":12,"minute":30}}'

Try it right here (no key)

Render a real chart right now

Enter a birth instant (UTC) — the engine renders a live, watermarked bodygraph and personal sky. Nothing is stored.

Full chart JSON + unwatermarked SVGs: get a free key (50 calls/month, no card).

Notes