MCP-server

Bygger du en agent behöver du ingen klientbiblioteksinstallation. MCP-servern ligger hostad hos oss och talar streamable HTTP.

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.

Två saker som gör den användbar för en agent

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.

Svaren är ärliga om osäkerhet. 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 den första träffen och rita en karta över fel ort. Det är precis den felformen som annars är osynlig: svaret ser rätt ut, kartan ritas, och ingen märker något förrän läsaren gör det.

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