API reference

OpenAPI 3.1 — interactive explorer below.

Quick start for AI agents

1. GET https://api.astronomycore.com/v1/capabilities (no auth)
2. Create ac_live_... key at dashboard
3. Call snapshots with Authorization: Bearer ac_live_...

curl -H "Authorization: Bearer ac_live_YOUR_KEY" \
  "https://api.astronomycore.com/v1/snapshots?latitude=41.9&longitude=12.5&include=minimal"

Machine-readable: openapi.yaml · llms.txt

MCP (Claude Desktop & Cursor)

The sky API is online; the MCP server is a local bridge that exposes REST endpoints as MCP tools. Claude and Cursor launch it on your machine — there is no hosted MCP URL yet.

1. Create an ac_live_... key at dashboard
2. Clone the repo, then npm install && npm run mcp:build in astronomy_core/
3. Point your MCP client at node /path/to/astronomy_core/mcp/dist/index.js
4. Set env ASTRONOMY_CORE_API_KEY=ac_live_...

Tools: get_capabilities, get_sky_snapshot, get_body, get_natal_chart

Full setup (Claude config JSON, Cursor, MCP Inspector): mcp/README.md · No MCP? Use REST above — same data, no local install.