프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

Nl MCP

제작자: GetApiNL버전 1.0.0i★ 0i클라우드에서 실행
레지스트리 이름nl.getapi/mcp

설치 방법

개요

제작자가 쓴 설명(영어 원문)

Nederlandse overheids- en registerdata via MCP: KVK, BAG, energielabel, kenteken, DSO en meer.

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

  • 연결 방식: 클라우드에서 실행
  • 전송 방식: Streamable HTTP
  • 카테고리: 기타

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

검사 4/4 통과 · 내가 묻는 내용은 제작자 서버(api.getapi.nl)를 거쳐요

먼저: 어떤 AI를 쓰시나요?

쓰는 앱을 고르면 아래에 단계가 나옵니다.

Claude에 연결할 수 있어요 · 약 5분

Nl MCP 키가 필요해요 (제작자 사이트에서 가입, 비용이 들 수 있음) · claude.ai나 데스크톱 앱에서 한 번 설정하면 채팅에서 쓸 수 있어요 · 무료 계정은 1개까지

  1. Nl MCP에 가입하고 키 만들기

    제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 비용이 들 수 있어요.

    키 받는 방법은 아래 제작자 README에 있어요

  2. Claude의 Connectors 페이지 열기

    CustomizeConnectors

    CustomizeConnectors1+ Add2https://…3Add4
  3. “+ Add” → “Add custom connector”를 누르고 이 2칸 채우기

    여기서 복사해 Claude의 같은 이름 칸에 붙여 넣고 Continue를 누르세요

    Name · 이름Nl MCP
    Remote MCP server URL · 주소https://api.getapi.nl/mcp

    Request headers에 이 이름과 값을 추가

    헤더 이름X-Api-Key
    값<여기에 키 붙여 넣기>

    키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요

    Authentication은 Claude가 찾은 그대로 두고 Add를 누르세요

  4. 채팅에서 켜기

    +ConnectorsNl MCP

  5. 해 보기

    Nl MCP을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Claude가 Nl MCP을 쓰고 있다고 하거나 답에 Nl MCP 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

ChatGPT는 아직 Nl MCP에 연결할 수 없어요

Nl MCP는 연결할 때 내 키가 필요한데, OpenAI 도움말은 OAuth 로그인만 설명하고 우리가 확인한 키 입력 방법이 없어요

대신 이렇게 할 수 있어요

A · Nl MCP에 연결되는 앱 쓰기

  • Nl MCP 키가 필요해요 (제작자 사이트에서 가입, 비용이 들 수 있음) · claude.ai나 데스크톱 앱에서 한 번 설정하면 채팅에서 쓸 수 있어요 · 무료 계정은 1개까지
  • Nl MCP 키가 필요해요 (제작자 사이트에서 가입, 비용이 들 수 있음)
  • Nl MCP 키가 필요해요 (제작자 사이트에서 가입, 비용이 들 수 있음)
  • Nl MCP 키가 필요해요 (제작자 사이트에서 가입, 비용이 들 수 있음)

B · 기타에서 ChatGPT에 연결되는 다른 서버

같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요

Claude Code에 연결할 수 있어요 · 약 5분

Nl MCP 키가 필요해요 (제작자 사이트에서 가입, 비용이 들 수 있음)

  1. Nl MCP에 가입하고 키 만들기

    제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 비용이 들 수 있어요.

    키 받는 방법은 아래 제작자 README에 있어요

  2. 터미널 열기

    Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기

  3. 이 명령을 붙여 넣고 Enter

    claude mcp add --transport http getapi https://api.getapi.nl/mcp --header 'X-Api-Key: your-value'

    Enter 전에 “your-value”를 내 키로 바꾸세요

    키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요

  4. Claude Code에서 /mcp 입력

    Nl MCP이 목록에 있고 연결됨으로 보이면 돼요

  5. 해 보기

    Nl MCP을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Claude Code가 Nl MCP을 쓰고 있다고 하거나 답에 Nl MCP 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Cursor에 연결할 수 있어요 · 약 5분

Nl MCP 키가 필요해요 (제작자 사이트에서 가입, 비용이 들 수 있음)

  1. Nl MCP에 가입하고 키 만들기

    제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 비용이 들 수 있어요.

    키 받는 방법은 아래 제작자 README에 있어요

  2. 이 버튼으로 Cursor 열기

    Cursor에서 열기

    Cursor가 설치를 확인하면 Install을 누르세요

  3. 키 입력

    Nl MCP 설정에서 X-Api-Key가 비어 있어요. 내 키를 넣고 저장하세요

    키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요

  4. Cursor에서 AI 채팅을 Agent 모드로 열기

  5. 해 보기

    Nl MCP을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Cursor가 Nl MCP을 쓰고 있다고 하거나 답에 Nl MCP 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

VS Code에 연결할 수 있어요 · 약 5분

Nl MCP 키가 필요해요 (제작자 사이트에서 가입, 비용이 들 수 있음)

  1. Nl MCP에 가입하고 키 만들기

    제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 비용이 들 수 있어요.

    키 받는 방법은 아래 제작자 README에 있어요

  2. 이 버튼으로 VS Code 열기

    VS Code에서 열기

    VS Code가 설치를 확인하면 Install을 누르세요

  3. 키 입력

    Nl MCP 설정에서 X-Api-Key가 비어 있어요. 내 키를 넣고 저장하세요

    키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요

  4. VS Code에서 AI 채팅을 Agent 모드로 열기

  5. 해 보기

    Nl MCP을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ VS Code가 Nl MCP을 쓰고 있다고 하거나 답에 Nl MCP 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

웹으로 연결하는 앱용 주소

주소https://api.getapi.nl/mcp

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? Nl MCP을 쓰는 사람에게 물어보세요💬 토론 →
개발자용: 터미널 명령과 JSON 설정

웹으로 연결

Claude Code

claude mcp add --transport http getapi https://api.getapi.nl/mcp --header 'X-Api-Key: your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "getapi": {
      "url": "https://api.getapi.nl/mcp",
      "headers": {
        "X-Api-Key": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "getapi": {
      "type": "http",
      "url": "https://api.getapi.nl/mcp",
      "headers": {
        "X-Api-Key": "your-value"
      }
    }
  }
}

직접 입력할 값

  • X-Api-Key HTTP header
    API key voor authenticatie

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

한눈에 보기

주간 다운로드i
npm/PyPI에 없음
확인된 도메인
✓ getapi.nl
라이선스i
라이선스 표시 없음
연결 방식
클라우드에서 실행
전송 방식
streamable-http
최신 버전i
1.0.0
카테고리i
기타
레지스트리 공개i
2026년 10월 17일
코드 마지막 변경i
2026년 10월 23일
제작자
GetApiNL
레지스트리 상태
활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

인터넷으로 연결하는 앱

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

모든 앱과 장단점 →

할 수 있는 일

도구 이름과 설명은 서버가 2026년 11월 7일에 알려 준 그대로예요. 우리가 아니라 제작자가 쓴 글이고, 일반 텍스트로만 보여 드려요.

  • kadaster.bag.address

    Address lookup by postcode and house number Returns full BAG address data for a Dutch address, including BAG IDs, usage purposes, surface area, build year, status, and GPS coordinates. Data is sourced from the PDOK BAG open API (Landelijke Voorziening BAG). Results are cached for

  • kadaster.bag.address.suggest

    Address autocomplete suggestions Returns address suggestions for autocomplete functionality based on a partial query. Useful for implementing address autocomplete in forms. Returns up to 10 suggestions with full address details and BAG identifiers. Results are cached for 1 hour.

  • kadaster.bag.id

    Address lookup by nummeraanduiding ID Returns full BAG address data for a given BAG nummeraanduiding ID. The nummeraanduiding ID is a 16-digit identifier from the BAG register. Data is sourced from the PDOK BAG open API (Landelijke Voorziening BAG). Results are cached for 24 hour

  • cbs.sbi

    SBI code index Returns all SBI codes from the local dataset. Optionally filter by `level` (1–5) and/or `parent_code` to retrieve only the direct children of a given SBI code. Levels: 1 = sectie (A–U), 2 = afdeling, 3 = groep, 4 = klasse, 5 = subklasse. Source: [CBS Standaard Bedr

  • cbs.sbi.search

    SBI code search Searches through all SBI codes and titles using a free-text query. Returns up to 25 matches, ordered by level (broad → specific) and code. Source: [CBS Standaard Bedrijfsindeling 2025](https://www.cbs.nl/sbi) Cost: 0.1 credit(s) per call. An API key is required vi

  • cbs.sbi.detail

    SBI code lookup Returns the title, description, level and full classification path for a single SBI code. Accepts both the dotted CBS format (`64.92.3`) and the numeric format (`64923`). Source: [CBS Standaard Bedrijfsindeling 2025](https://www.cbs.nl/sbi) Cost: 0.1 credit(s) per

  • lookup.dns.nameservers

    Nameserver lookup for a domain Returns the NS records for the given domain. Results are cached for 10 minutes. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer ); a per-call wallet payment via x402 is also accepted.

  • lookup.dns.records

    DNS record lookup for a domain and record type Returns DNS records of the specified type for a domain. Supported types: A, AAAA, CNAME, MX, NS, TXT, SOA, PTR, SRV, ALL (default). Results are cached for 5 minutes. Cost: 1 credit(s) per call. An API key is required via the X-Api-Ke

  • validation.dnsbl

    Check an IP address against DNS-based blacklists (RBLs) Checks an IP address against 5 public DNSBL / RBL zones (Spamhaus, SpamCop, SORBS, Barracuda, PSBL) by querying their DNS-based blacklists. This is a lightweight, realtime check without any external API calls or rate limits.

  • dso.documents

    Search environmental documents Searches environmental documents (Omgevingswet and Wro) in context for the given location. Returns all applicable plans, environmental plans and related documents. Accepts coordinates or a postcode. Source: [DSO Omgevingsinformatie Ontsluiten v2](ht

  • dso.plans

    Search spatial plans Searches spatial plans (Wro) for the given location. Returns zoning plans, integration plans and amendment plans that affect the location. Accepts coordinates or a postcode. Source: [DSO Ruimtelijke Plannen Opvragen v4](https://developer.omgevingswet.overheid

  • validation.email

    Validate an email address Checks the RFC format and verifies that the domain has a valid DNS or MX record. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer ); a per-call wallet payment via x402 is also accepted.

  • validation.email.batch

    Validate a batch of email addresses Validates up to 25 email addresses in a single request. Each address is checked for RFC format and DNS/MX record existence. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer ); a per-call wall

  • validation.email.disposable

    Disposable email domain checker Checks the domain against a continuously updated blocklist of known throwaway email services (Mailinator, Guerrilla Mail, 10minutemail, etc.). Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer );

  • lookup.postcode

    Zipcode lookup for the Netherlands Returns address data for a Dutch postcode, optionally refined by house number. There are multiple sources available with varying coverage and accuracy. Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorizati

  • validation.iban

    Validate an international IBAN / BIC Validates an IBAN (ISO 13616) fully offline: country-specific length + structure and the mod-97 check digit. Supported for 70+ countries. For Dutch IBANs the bank name and BIC are resolved from the bank code. An optional BIC can be submitted t

  • lookup.ip

    Get ISP information and location details for an IP address Returns location, ISP, organisation and hosting details for a given IP address. Results are cached for 1 hour. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer ); a per

  • ndw.laadpunten

    Charging points list Returns a list of all publicly accessible charging points in the Netherlands. Data comes from the NDW Open Data platform (DOT-NL); each charging point includes all available source fields, including the complete `availabilities` (counts, power, current type,

  • ndw.laadpunten.detail

    Charging point detail Returns the details of a single charging point by external ID (EVSEId or locationId), including all available NDW fields and the complete availabilities. Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer

  • ndw.emissiezones

    Emission zones list Returns an overview of all environmental zones (low-emission and zero-emission zones) in the Netherlands. Data comes from the NDW Open Data platform (DATEX II format). Optionally paginate with `page` (plus `per_page`, max 500; only then does the response conta

  • ndw.emissiezones.detail

    Emission zone detail Returns the details of a single emission zone by external ID, including the zone's GeoJSON geometry and vehicle restrictions. Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer ); a per-call wallet payment

  • ndw.truckparking

    Truck parking list Returns an overview of all truck parking locations in the Netherlands with current occupancy information. Static location data is combined with dynamic occupancy status (DATEX II). Optionally paginate with `page` (plus `per_page`, max 500; only then does the re

  • ndw.truckparking.detail

    Truck parking detail Returns the details of a single truck parking location by external ID. Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer ); a per-call wallet payment via x402 is also accepted.

  • property.pandgegevens

    Property data lookup (pandgegevens) Returns combined property data for a Dutch address: Address details + BAG identifiers, Energy label info, property value (WOZ waarde), spatial planning data, and environmental information. The `energy_labels` block contains every EP-Online labe

  • property.pandgegevens.lite

    Lightweight property data lookup (pandgegevens lite) Returns property data for a Dutch address: Address details + BAG identifiers, energy label info, and building characteristics. The `energy_labels` block contains all EP-Online labels (complete records); the summary blocks show

  • property.woz.waarde

    WOZ-value lookup (WOZ-waarde) Returns the Dutch government property assessment value (WOZ-waarde) for a property, including the historical values of the last three years. Alongside the value, the ground area of the WOZ object (grondoppervlakte) and the linked cadastral parcel (ka

  • rdw.vehicle

    Vehicle lookup by Dutch license plate (kenteken) — Pro / extended response Returns vehicle registration data from the RDW Basisregistratie Voertuigen, enriched with fuel + emission information, a national milieuzone compliance flag, and a wide range of extended fields: catalogusp

  • property.energy.label

    Energy label lookup for a Dutch address Returns the registered energy label(s) for a Dutch address from EP-Online (RVO). Each label carries the complete EP-Online record (field names are translated to English; fields that EP-Online does not provide for that label are `null`). Res

  • scraping.email

    E-mail Address Extractor Uses a simple regex to extract email addresses from the HTML content of a given URL. It is not always possible to extract email addresses due to obfuscation techniques. In such cases, the api will try to decode it. If it still fails, it will return an emp

  • validation.vat

    Validate an EU VAT number (VIES) Validates a European VAT number via the official VIES system of the European Commission. The country code must be the first two characters of the VAT number (e.g. `NL820646660B01`). Supported countries: all 27 EU member states + Northern Ireland (

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 11일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 도메인 getapi.nl 기준으로 확인되었어요(레지스트리가 도메인 소유를 확인해요)

  • ✓ 통과

    계속 관리되고 있음

    코드 마지막 변경: 19일 전

  • … 아직 점검 안 함

    라이선스 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • ✓ 통과

    엔드포인트 응답

    902ms 만에 응답(HTTP 200)

  • – 해당 없음

    OAuth로 로그인

    로그인 필요 없음

  • ✓ 통과

    도구 설명에 숨겨진 지시 없음

    도구 설명 30개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

Google로 로그인하고 글쓰기

사용자 리뷰

아직 리뷰가 없어요

Google로 로그인하고 리뷰 쓰기

기타 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 19139개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 19139개 중 63%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 19139개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Nl MCP, 안전한가요?

해당하는 기본 점검 4개 중 4개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

제작자의 클라우드에서 실행돼요. 설치 없이 인터넷으로 연결하지만, 보내는 내용은 제작자의 서버를 거쳐요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 19일 전 변경됐고, 최신 버전(1.0.0)은 25일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되므로 원격 MCP를 지원하는 앱에서도 쓸 수 있어요. 예: ChatGPT Business 이상.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: World Monitor, Claude Flow, Tldraw

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 102 tools.

제작자: koala73널리 사용됨★ 9만6일 전 업데이트

클라우드에서 실행✓ worldmonitor.app

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

제작자: ruvnet널리 사용됨↓ 1.4만/주★ 8.1만14개월 전 업데이트

내 컴퓨터에서 실행

Tldraw

Draw and visually collaborate with your agents on tldraw's canvas.

제작자: tldraw널리 사용됨★ 5.1만8개월 전 업데이트

클라우드에서 실행

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

GetApi MCP Server

Een MCP-server die de GetApi-API beschikbaar maakt voor AI-clients zoals Claude Desktop.

Installatie

Installeer de server via npm:

npm install -g getapi-mcp

Wat het doet

Deze server maakt alle GetApi API-endpoints beschikbaar als tools voor AI-clients. De server communiceert via stdio en wordt gestart met npx getapi-mcp. De API-key wordt uitsluitend via de omgevingsvariabele API_KEY ingesteld.

Vereisten

  • Node.js 20 LTS of nieuwer
  • Een actieve GetApi API-key

Configuratie

CLI gebruik
npx getapi-mcp
MCP Server configuratie

Voeg de volgende configuratie toe aan de MCP-configuratie van je client (bijvoorbeeld claude_desktop_config.json voor Claude Desktop):

{

"mcpServers": { "getapi": { "command": "npx", "args": ["-y", "getapi-mcp@0.1.0"], "env": { "API_KEY": "ga_live_xxxxxxxxxxxxxxxxxxxx" } } } }

Belangrijk: De API-key wordt alleen via env ingesteld. De server redigeert de key volledig uit logs en output.

API Key verkrijgen

Je moet een actieve API-key van GetApi hebben. Zie hun dashboard voor informatie over het aanmaken en beheren van keys.

Opmerking: De key moet het formaat ga_live_xxxxx of ga_test_xxxxx hebben.

Beschikbare tools

De tool-lijst wordt automatisch gegenereerd uit de GetApi OpenAPI spec en wordt elk uur geüpdatet.

Voorbeeld tools
ToolOmschrijving
getapi_kadaster_bag_addressAdres zoeken op postcode en huisnummer (BAG)
getapi_kadaster_bag_address-suggestAdres-autocomplete suggesties
getapi_kadaster_bag_idAdres zoeken op nummeraanduiding-ID
getapi_lookup_postcodePostcode-lookup (NL)
getapi_lookup_ipIP-/ISP-informatie
getapi_validation_ibanIBAN / BIC valideren
getapi_validation_vatEU BTW-nummer valideren (VIES)
getapi_property_pandgegevensPandgegevens op postcode en huisnummer
getapi_rdw_vehicleVoertuig op kenteken (RDW)
getapi_lookup_dns_recordsDNS-records van een domein
...De volledige lijst wordt uit de OpenAPI spec gegenereerd

Bekijk de GetApi API-documentatie voor de volledige lijst van endpoints.

Gebruik

Tool aanroepen
  1. Klik op het MCP icoontje (meestal in de chat interface)
  2. Voeg de GetApi server toe als een MCP server
  3. Klik op een tool in het MCP paneel
  4. Vul de vereiste parameters in
  5. De tool wordt uitgevoerd en het resultaat wordt weergegeven
Foutcodes

Als er een netwerkfout optreedt, krijg je een specifiek foutbericht:

CodeOmschrijvingOplossing
404Resource niet gevondenCheck de URL en parameters
400Fout bij parametersControleer de parameters op syntaxis
422ValidatiefoutControleer de parameter types
503Server tijdelijk niet beschikbaarProbeer het later opnieuw
TIMEOUTRequest time-outVerhoog de timeout
401Ongeldige API keyControleer je API key
Beveiliging
  • De API-key wordt nooit in logs, output of tool-results weergegeven
  • Alle verzoeken gaan alleen naar https://api.getapi.nl
  • De server redacteert automatisch API-keys in logs
  • Keys worden nooit naar GetApi verzonden

Automatische updates

De server checkt elk uur of de GetApi spec is gewijzigd. Bij updates:

  • De tool-lijst wordt automatisch bijgewerkt
  • De client ontvangt een melding (afhankelijk van client-support)
  • Ongeldige specs worden genegeerd met fallback op laatste goede versie

Opmerking: Niet alle MCP-clients verwerken automatische updates. Herstart je client als je nieuwe tools wilt zien.

Bekende beperkingen

  1. x402 endpoints: Betaalbare AI-endpoints worden niet beschikbaar gesteld (niet vereist voor AI-clients)
  2. Client support: Herstart je client als de tool-lijst is gewijzigd
  3. Timeout: Verzoeken hebben een time-out van 10 seconden
  4. Response size: Maximaal 1 MB response
  5. Spec size: OpenAPI spec mag maximaal 5 MB zijn

Configuratie opties

Deze waarden zijn op dit moment vast in de server ingesteld (niet via env aanpasbaar); alleen API_KEY is een omgevingsvariabele.

OptieDefaultOmschrijving
specUrlhttps://api.getapi.nl/docs/api.jsonURL naar de GetApi OpenAPI spec
baseUrlhttps://api.getapi.nlBase URL voor API verzoeken
authHeaderX-Api-KeyHeader naam voor auth
refreshIntervalMs3600000 (1 uur)Interval waarmee de spec wordt gecontroleerd
timeoutMs10000Request timeout (ms)
maxResponseSize1048576Max response size (1 MB)
maxSpecSize5242880Max spec size (5 MB)
x402ExcludedOperationsleegOperation-IDs die niet als tool worden geëxporteerd
Voorbeeld configuratie

De enige omgevingsvariabele is API_KEY:

{

"mcpServers": { "getapi": { "command": "npx", "args": ["-y", "getapi-mcp@0.1.0"], "env": { "API_KEY": "ga_live_xxxxxxxxxxxxxxxxxxxx" } } } }

Troubleshooting

"API_KEY is niet ingesteld of ongeldig"

De server stopt met deze melding als API_KEY ontbreekt of niet met ga_live_/ga_test_ begint. Stel de variabele in via je MCP client configuratie (zie Configuratie).

"Geen spec beschikbaar"
  • De spec-URL (https://api.getapi.nl/docs/api.json) is niet bereikbaar
  • De GetApi spec is tijdelijk niet beschikbaar
  • Check je internetverbinding

De server start in dat geval met alleen de getapi_ping fallback-tool en probeert het bij de volgende refresh opnieuw.

"Parameter validation failed"
  • Controleer de parameter namen en types tegen de inputSchema van de tool
  • Verplichte parameters staan in required
Fout met statuscode (bijv. 401/404)
  • 401: ongeldige of ontbrekende API-key
  • 404: verkeerde parameters of onbekend endpoint
  • 503/504: API tijdelijk niet beschikbaar of timeout

Ontwikkelen & testen

# Afhankelijkheden installeren

npm install

Alles valideren: typecheck + lint + build + tests (unit + e2e)

npm run validate

Volledige check inclusief smoke-test van het gepackagede npm-artefact

npm run verify

Alleen de tests

npm test

Tests met coverage (en coverage-thresholds)

npm run test:coverage

Documentatiecheck: links, ankers, versies en config-waarden

npm run check:docs

Live contract test tegen de echte API (vereist API_KEY)

API_KEY=ga_test_... npm run test:live

Smoke-test: pakt + installeert + start het echte pakket

npm run test:package

Typecheck / lint afzonderlijk

npm run typecheck npm run lint

Bouwen naar dist/

npm run build

CI draait deze checks automatisch: .github/workflows/ci.yml op elke push/PR en .github/workflows/release.yml vóór publicatie.

De server lokaal draaien

De server praat via stdio met een MCP-client. Voor een snelle handmatige controle kun je hem direct starten en hem JSON-RPC-berichten op stdin sturen:

# Start de server (met een geldige ga_live_/ga_test_ key)

API_KEY="ga_test_1234567890" node dist/bin.js

Stuur vervolgens bijvoorbeeld deze regel naar stdin:

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"cli","version":"1.0.0"}}}

Alle logregels verschijnen op stderr; stdout bevat uitsluitend JSON-RPC. Zo zie je direct of de server correct opstart en welke tools beschikbaar zijn.

Draaien in een MCP-client

Gebruik de configuratie onder MCP Server configuratie. De client start de server zelf via stdio (command: "npx") en geeft de API-key via env mee; er is geen poort of URL nodig.

Versies

Zie de CHANGELOG voor een lijst van updates en verbeteringen.

Licentie

MIT License - zie LICENSE voor details.

Support

Voor vragen, bugs en suggesties, neem contact op via:

  • Email: info@wdnoord.nl
  • GitHub Issues: https://github.com/GetApiNL/mcp-server/issues

Let op: Deze server werkt alleen met een actieve GetApi API-key. Zonder geldige API-key werkt de server niet.