MCP-server

MCP-servern ligger hos oss och talar streamable HTTP. Inget klientbibliotek att installera.

claude mcp add --transport http kart-api https://api.kart-api.se/mcp

I en klient som konfigureras med JSON (Cursor, Windsurf, VS Code):

{
  "mcpServers": {
    "kart-api": { "type": "http", "url": "https://api.kart-api.se/mcp" }
  }
}

Ingen nyckel behövs för att komma igång — samma kvot som resten av API:t, 200 anrop per dygn. Vill du ha mer: skicka nyckeln som huvud, "headers": { "X-API-Key": "ka_…" }.

Verktygen

Verktyg	Vad det gör
`geocode`	Svensk plats eller adress → koordinat, med flertydighet utskriven.
`reverse_geocode`	Koordinat → närmaste ortnamn och kommun.
`ortnamn`	Sök i Lantmäteriets 990 698 ortnamn.
`kommun_lookup`	Vilken kommun och vilket län ligger punkten i?
`hojd`	Höjd över havet i meter.
`rendera_karta`	Bygger en URL till en färdig kartbild med markör.

Vad agenten får med sig

Verktygsbeskrivningarna bär licenskravet i klartext. En agent som hämtar data via oss får alltså med sig att attributionen ska visas, och för den vidare till sin användare. Ett verktyg som tiger om villkoren gör användaren till licensbrytare utan att någon märker det.

Flertydigheten står i svaret. geocode skickar med i hur många kommuner namnet finns, så en agent kan fråga tillbaka i stället för att välja första träffen och rita en karta över fel ort. Den felformen är annars osynlig: svaret ser rätt ut och kartan ritas.

Testa handskakningen

curl -s -X POST https://api.kart-api.se/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | head -c 400