API & MCP

Everything a person can do on Skyfold Cosmic Odometer, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

• POST https://skyfoldcosmicodometer.usefulweb.app/api/v1/calculate – run Skyfold Cosmic Odometer
• GET https://skyfoldcosmicodometer.usefulweb.app/api/v1/tool – inputs, output schema, examples
• OpenAPI 3.1: /openapi.json · /openapi.yaml
• Errors: application/problem+json; 422 includes per-field errors.

Skyfold Cosmic Odometer

From a start date such as your birthday, computes the distance travelled with the Earth’s rotation at your latitude, around the Sun (integrated from VSOP87), around the Milky Way and relative to the cosmic background radiation, with orbits, full Moons and stars whose light left them when you were born.

Example request

Since the year 2000, at the equator

curl -X POST https://skyfoldcosmicodometer.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"startDate":"2000-01-01","startTime":"00:00","endDate":"2026-11-07","timeZone":"UTC","latitude":0}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

• Streamable HTTP endpoint: https://skyfoldcosmicodometer.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
• Tools: skyfold_cosmic_odometer
• Local stdio connector: node src/mcp-stdio.ts --tool=skyfold-cosmic-odometer

{
  "mcpServers": {
    "skyfold-cosmic-odometer": { "type": "http", "url": "https://skyfoldcosmicodometer.usefulweb.app/mcp" }
  }
}