MCP-server — danske ejendomsdata til din AI-agent
Model Context Protocol (MCP) er den åbne standard, AI-agenter bruger til at kalde eksterne værktøjer. Grundfasts MCP-server udstiller registrene som værktøjer: din agent forbinder til https://api.grundfast.dk/mcp med en almindelig gf_-nøgle og kan slå BBR, Matriklen, adresser, CVR, højder og stednavne op — metered og faktureret præcis som REST.
POST /mcpHvad MCP-serveren giver dig
Ét endpoint, alle registre
Én MCP-forbindelse giver din agent 12 værktøjer over seks registre — BBR, Matriklen, adresser (DAR), CVR, højdemodel (DHM) og stednavne — plus GeoDanmarks bygningspolygoner, uden at du selv skal wrappe hvert REST-kald som et tool.
Din egen gf_-nøgle
Autentificér med en helt almindelig gf_live_- eller gf_test_-nøgle i Authorization-headeren. Samme nøgle, samme metering og samme månedskvote som REST-API’et — MCP-kald bogføres præcis som /v1-kald.
Stateless & standard
Streamable HTTP med JSON-RPC 2.0 og uden session-id’er — protocolVersion 2025-06-18. Virker ud af boksen med Claude Code, Claude Desktop, Cursor og enhver anden MCP-klient.
Ryddede data, cachet mirror
Værktøjerne returnerer nøjagtig samme svar som REST: Grundfasts ryddede model med oversatte koder, WGS84-geometri og gensammensatte navne — serveret fra den cachede SLA-mirror, så den står op selv når Datafordeler flapper.
Endpoint & nøgle
MCP-serveren kører på POST /mcp som stateless JSON-RPC 2.0 over HTTP. Send din gf_live_- eller gf_test_-nøgle som Authorization: Bearer … — samme auth og metering som de øvrige registre. En nøglefri forespørgsel giver 401.
# MCP-endpoint (JSON-RPC 2.0 over HTTP), Bearer gf_live_… eller gf_test_…: POST https://api.grundfast.dk/mcp Authorization: Bearer gf_live_... → initialize → tools/list (12 værktøjer) → tools/call { name, arguments }
De 12 værktøjer
Hvert værktøj svarer til et REST-endpoint og returnerer den samme JSON. Et opslag på en ukonfigureret kilde eller et ugyldigt argument markeres som isError i tool-svaret — ikke som en protokolfejl.
| Værktøj | Input | Hvad |
|---|---|---|
bbr_ejendom | { bfe } | BBR-rollup for en ejendom (bygninger, enheder, grund) på BFE-nummer. |
bbr_historik | { bfe } | Bitemporal versionshistorik for en BBR-ejendom — hver bygnings registreringstidslinje (nyeste først) med registrering/virkning-tidsstempler. |
matrikel_ejendom | { bfe } | Matrikel-rollup — jordstykker og ejerlavsnavn — på BFE-nummer. |
adresse_soeg | { q, per_side? } | Autocomplete på danske adresser (DAR) fra fritekst. |
adresse_opslag | { uuid } | Slå en DAR-adresse-UUID op → ren, struktureret adresse med BFE-bro. |
adresse_historik | { uuid } | Bitemporal versionshistorik for en DAR-adresse-UUID — registreringstidslinjen (nyeste først) for adresse- eller husnummer-entiteten. |
adresse_datavask | { betegnelse } | Vask en beskidt adressestreng → rangerede kandidater + A/B/C-bånd. |
adgangsadresse_reverse | { lon, lat, radius_m? } | Nærmeste adgangsadresser til en koordinat (reverse geocoding). |
cvr_virksomhed | { cvr } | Slå en virksomhed op på CVR-nummer → ren, gensammensat post. |
dhm_hoejde | { lon, lat } | Terræn- og overfladehøjde (DHM) ved en koordinat. |
stednavne_naer | { lon, lat, radius_m? } | Danske stednavne nær en koordinat. |
geodanmark_bygninger | { bfe } | GeoDanmark-bygningsfodaftryk (WGS84-polygoner) på BFE-nummer. |
Opsætning
Tilføj serveren i din foretrukne klient med din egen nøgle. Alle tre bruger samme endpoint og Authorization-header.
Claude Code
# Claude Code (CLI) — HTTP-transport med din nøgle: claude mcp add --transport http grundfast \ https://api.grundfast.dk/mcp \ --header "Authorization: Bearer gf_live_..."
Claude Desktop
{ "mcpServers": { "grundfast": { "type": "http", "url": "https://api.grundfast.dk/mcp", "headers": { "Authorization": "Bearer gf_live_..." } } } }
Cursor
// eller .cursor/mcp.json i projektet { "mcpServers": { "grundfast": { "url": "https://api.grundfast.dk/mcp", "headers": { "Authorization": "Bearer gf_live_..." } } } }
Giv din agent adgang til ejendomsdata
Opret en gratis nøgle, tilføj MCP-serveren i din klient og lad agenten slå BBR, Matriklen, adresser og CVR op — uden at du bygger et eneste tool selv.
Se også BBR-API’et, CVR-API’et og Adresse-API’et (DAR).
Ofte stillede spørgsmål
Hvad koster MCP-kald?
MCP måles præcis som REST. Hvert tools/call tæller som ét kald mod din plan (Free / Starter / Pro / Scale) med samme metering, burst-grænse og overforbrug som /v1. Der er ingen særskilt MCP-pris — det er den samme nøgle og den samme kvote.
Virker gf_test_-nøgler mod MCP-serveren?
Ja. En sandkasse-nøgle (gf_test_) virker mod /mcp — gratis, aldrig faktureret, mod en separat månedlig sandkasse-grænse og med live registerdata via SLA-mirroren. Perfekt til at bygge og teste din agent-integration, før du skifter til en gf_live_-nøgle.
Er der rate limits?
Ja — samme per-nøgle burst-grænse som REST (skalerer med din plan) oven på den månedlige kvote. Rammer du grænsen, får du en 429; ellers svarer MCP-serveren med HTTP 200 og JSON-RPC-resultatet (tool-fejl markeres med isError, ikke som en protokolfejl).
Hvilke data får agenten adgang til?
De samme registre som REST-API’et — BBR, Matriklen, DAR (adresser), CVR, DHM og Stednavne — plus GeoDanmark-bygningspolygoner, udstillet som 12 værktøjer. (DAGI-administrativ geografi har endnu ikke et MCP-værktøj — kald den via REST.) Kun offentlige registerdata i Grundfasts ryddede form; vi bruger ikke adgangsbegrænsede person-entiteter som CVRPerson eller ejerfortegnelsen.
Hvordan forbinder jeg fra Claude eller Cursor?
Tilføj serveren med din gf_-nøgle i Authorization-headeren (se opsætning ovenfor). MCP-serveren er stateless Streamable HTTP (JSON-RPC 2.0, protocolVersion 2025-06-18) på https://api.grundfast.dk/mcp — så den virker med Claude Code, Claude Desktop, Cursor og enhver MCP-klient.
Din agent når hvert register i landet
Tilslut MCP-serveren én gang, og din agent kan slå ejendomsdata op hvor som helst i Danmark — BBR, Matriklen, adresser, CVR, højder og stednavne over 2.700.904 adresser og 98 kommuner, gennem ét endpoint og din egen gf_-nøgle.