Skip to content
Auspex
Sky API

The sky, for your agents.

The same live tools the satellites use to answer, as a REST API and an MCP server. Plug Auspex into Claude, Cursor or any assistant that speaks MCP, or call it from your own code.

MCP server

Connect an assistant

Endpoint https://askauspex.fun/mcp, Streamable HTTP, stateless JSON-RPC over POST. It lists 8 tools: overhead, satellite, passes, constellation-stats, starlink-trains, launches, weather, close-approaches.

Claude Code

claude mcp add --transport http auspex https://askauspex.fun/mcp

Cursor and other clients that take a server URL (mcp.json)

{
  "mcpServers": {
    "auspex": {
      "url": "https://askauspex.fun/mcp"
    }
  }
}

With a holder key

{
  "mcpServers": {
    "auspex": {
      "url": "https://askauspex.fun/mcp",
      "headers": {
        "Authorization": "Bearer ausp_your_key"
      }
    }
  }
}
REST

Endpoints

GET requests return JSON with ok, source and data. When there is no data, ok is false and note says why. Locations are rounded to 0.1 degree before use. Machine-readable index: /api/v1.

curl "https://askauspex.fun/api/v1/overhead?lat=51.5&lon=-0.1"
GET/api/v1/overhead

Satellites above the horizon right now at a location: total, counts by type, the highest one and the oldest one.

lat (required), lon (required)
GET/api/v1/satellite

Look up an active satellite by name or NORAD id: owner, type, launch date, orbit, altitude, speed, period.

query (required)
GET/api/v1/passes

Upcoming passes over a location and whether each is visible to the naked eye. filter: 'visible' (default), 'all', or a satellite name or NORAD id such as 'iss'.

filter, hours, limit, lat (required), lon (required)
GET/api/v1/constellation-stats

How many satellites of a constellation (starlink, oneweb, kuiper, qianfan, gps, galileo, ...) are active, and how many are over a region right now (europe, north america, south america, africa, asia, oceania) or above the user's horizon.

name (required), region, lat (required), lon (required)
GET/api/v1/starlink-trains

Recently launched Starlink batches still flying in a line, and their passes over a location with naked-eye visibility.

hours, lat (required), lon (required)
GET/api/v1/launches

Next rocket launches from the Launch Library 2 cache, with distance from the location and a rough note on whether it could be seen.

n, lat (required), lon (required)
GET/api/v1/weather

Cloud cover at a location from MET Norway, at a given time (ISO 8601, default now) and for the next hours.

time, lat (required), lon (required)
GET/api/v1/close-approaches

Closest predicted approaches between satellites in the next hours, from CelesTrak SOCRATES: the two objects, miss distance, time and relative speed.

hours, limit, norad