API catalog

118 of 118 APIs

$ cat for-agents.md

Connect an agent

Everything on this page is available as one machine-readable JSON document with a stable URL. Three documented ways to consume it:

1 Fetch the catalog directly

Any agent that can make HTTP requests can use the catalog as a tool-selection index. Pick entries by when_to_use, call them via sample_request.

curl -s https://trym.cloud/labs/open-apis/catalog.json \
  | jq -r '.entries[] | select(.category == "weather") | .id'

Shape: meta (counts, freshness, source commit) + entries[] (id, when_to_use, when_not_to_use, sample_request, agent_recipe, auth_type, license, probe). Also listed in llms.txt.

2 Via MCP

Any MCP client with an HTTP fetch tool can read the catalog — for example the reference mcp-server-fetch from the Model Context Protocol project:

{
  "mcpServers": {
    "fetch": { "command": "uvx", "args": ["mcp-server-fetch"] }
  }
}

Then instruct the agent: “Fetch https://trym.cloud/labs/open-apis/catalog.json, pick the entry whose when_to_use matches the task, and follow its sample_request.” A dedicated MCP server for this catalog is on the roadmap — it is not shipped yet.

3 Health-check before you call

The live probe answers “does this API respond right now?” from Cloudflare's edge. It only accepts catalog entry ids — no arbitrary URLs — and results are cached for 5 minutes.

curl -s 'https://trym.cloud/labs/open-apis/api/probe?id=met.locationforecast'

Returns ok, http_status, latency_ms, content_type and a sanitized excerpt. GET only, 8s timeout, 2 KB read cap, redirects reported but never followed.

$ cat about.md

What this is — and isn't

Open APIs for Agents is built and operated by Trym Håkansson through Håkansson Labs. The underlying APIs belong to their providers — Meteorologisk institutt, Kartverket, Brønnøysundregistrene and 28 more — and each remains governed by its provider's own license and terms. Every entry carries provider attribution, license and source links.

The metadata is curated from the providers' public documentation by an autonomous pipeline with deterministic checks; 43 of 118 entries also carry a pipeline verification timestamp, and the live probe re-checks any entry on demand. Entries that don't yet meet the bar stay quarantined (481 in staging) and are not published here.

Built on the same conviction that shipped Politipuls — a live product on top of Norwegian public data. This catalog is free to use; no accounts, no tracking beyond the site's standard analytics.