プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Nl MCP

作者:GetApiNLバージョン 1.0.0i★ 0iクラウドで動く
レジストリ名nl.getapi/mcp

インストール方法

What it does

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

  • Connects クラウドで動く
  • Account or key Works without a key · add X-Api-Key if you have one (often raises limits)
  • Category その他

インストール

使っているAIアプリを選んで、設定をコピーしてください。

チェック 4/4 合格 · 質問内容は提供元のサーバー(api.getapi.nl)を通ります · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Nl MCP
    Remote MCP server URL · アドレスhttps://api.getapi.nl/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsNl MCP

  4. 試してみる

    Nl MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Nl MCP を使っていると言うか、回答に Nl MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前Nl MCP
    Connection · アドレスhttps://api.getapi.nl/mcp
  3. チャットで Nl MCP を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から Nl MCP を選びます

  4. 試してみる

    Nl MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が Nl MCP を使っていると言うか、回答に Nl MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user getapi https://api.getapi.nl/mcp
  3. Claude Code で /mcp と入力

    Nl MCP が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    Nl MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Nl MCP を使っていると言うか、回答に Nl MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    Nl MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Nl MCP を使っていると言うか、回答に Nl MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    Nl MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Nl MCP を使っていると言うか、回答に Nl MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://api.getapi.nl/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Nl MCP を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user getapi https://api.getapi.nl/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "getapi": {
      "url": "https://api.getapi.nl/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "getapi": {
      "type": "http",
      "url": "https://api.getapi.nl/mcp"
    }
  }
}

自分で入力する値

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

説明は英語の原文のままです。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
確認済みドメイン
✓ getapi.nl
接続方法
クラウドで動く
トランスポート
streamable-http
最新バージョンi
1.0.0
カテゴリi
その他
レジストリ公開日i
2026年10月17日
コードの最終更新i
2026年11月13日
作者
GetApiNL
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

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

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月13日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • 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

  • kvk.validate

    Validate a Dutch KVK number (Handelsregister) Quick validation check: is a KVK number registered and active? Returns simple true/false. Local cache (48 hours) serves repeated requests. When the source is temporarily unavailable we return HTTP 503 with `found` and `valid` set to n

  • kvk.search

    Search businesses Search our company database by company name or KVK number. A local cache (48 hours) serves repeated queries. Results per page can be: 5, 10, 25, 50, or 75 (default 25). KVK API caps results at 50 per request. At least one of `naam` or `kvkNummer` is required. Co

  • kvk.detail

    KVK detail Returns name, address and active status for a KVK number from our company data. Local cache (48 hours) serves repeated requests. 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

  • 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月14日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名はドメイン getapi.nl で確認済みです(レジストリがドメインの所有を確認しています)

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • – 対象外

    ライセンスがある

    対象外:getapi.nl の所有者が自ら運営するクラウドのサーバーで、リポジトリのコードを実行しません

  • ✓ 合格

    エンドポイントが応答する

    753ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    33件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

Google でログインして投稿

ユーザーレビュー

まだレビューはありません

Google でログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの19754件のうち0%よりスターが多い
  • このカテゴリのほかの19754件のうち60%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの19754件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Nl MCPは安全ですか?

当てはまる基本チェック4項目のうち4項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(1.0.0)がレジストリに届いたのは28 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:World Monitor, Claude Flow, Windmill

同じカテゴリのほかの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

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

作者:koala73広く使われている★ 9.1万昨日更新

クラウドで動く✓ 提供元 · worldmonitor.app

Claude Flow

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

作者:ruvnet広く使われている↓ 1.4万/週★ 8.2万14 か月前更新

パソコンで動く

Windmill

Run Windmill scripts and flows and manage jobs, schedules, resources and variables.

作者:windmill-labs広く使われている★ 1.9万一昨日更新

クラウドで動く

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

GetApi MCP Server

Eén endpoint met 33 tools voor Nederlandse overheids- en registerdata: KVK, BAG, WOZ, energielabel, kenteken, DSO, NDW en validatie.

De server draait hosted op https://api.getapi.nl/mcp. Installeren is niet nodig.

Snel starten

Voeg dit toe aan de MCP-configuratie van je client (claude_desktop_config.json, mcp.json of vergelijkbaar):

{

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

  • Transport: streamable HTTP, protocolversie 2025-06-18
  • initialize en tools/list antwoorden zonder sleutel, zodat je eerst kunt zien wat er is
  • tools/call vraagt een sleutel en antwoordt zonder sleutel met 401

Authenticatie

RouteHeaderWaarvoor
API-sleutelX-Api-Key: ga_live_...normaal gebruik
Bearer-tokenAuthorization: Bearer ga_live_...clients die alleen Bearer ondersteunen
x402betaling per call vanuit een walletagent zonder account

Een sleutel maak je aan in het dashboard. Het formaat is ga_live_... of ga_test_.... Maak per client een eigen sleutel, dan zie je het verbruik apart terug.

Kosten

De MCP-server is een dunne laag over dezelfde endpoints als de REST-API. Je verbruikt dezelfde credits per call en er is geen apart MCP-abonnement. Zonder sleutel kun je de tools bekijken, niet aanroepen.

Tools

De lijst wordt gegenereerd uit de OpenAPI-specificatie van GetApi. Namespaces zijn gescheiden met punten.

Adres, pand en energie
ToolWat het doet
kadaster.bag.addressAdres op postcode en huisnummer (BAG)
kadaster.bag.address.suggestAdres-suggesties voor autocomplete
kadaster.bag.idAdres op nummeraanduiding-ID
property.pandgegevensPandgegevens, uitgebreid
property.pandgegevens.litePandgegevens, licht
property.woz.waardeWOZ-waarde
property.energy.labelGeregistreerd energielabel
lookup.postcodePostcode-lookup
Bedrijven
ToolWat het doet
kvk.validateKVK-nummer geldig?
kvk.searchBedrijven zoeken op naam of nummer
kvk.detailKVK-detail: naam, adres, status
cbs.sbiSBI-codetabel
cbs.sbi.searchSBI-codes zoeken op tekst
cbs.sbi.detailSBI-code met titel en classificatiepad
Voertuigen en mobiliteit
ToolWat het doet
rdw.vehicleVoertuig op kenteken (uitgebreide respons)
ndw.laadpuntenLaadpunten in Nederland
ndw.laadpunten.detailLaadpunt-detail (EVSE)
ndw.emissiezonesMilieuzones
ndw.emissiezones.detailMilieuzone-detail
ndw.truckparkingTruckparkings
ndw.truckparking.detailTruckparking-detail
Omgeving
ToolWat het doet
dso.plansBestemmingsplannen (Wro) op locatie
dso.documentsOmgevingsdocumenten zoeken
Validatie en netwerk
ToolWat het doet
validation.emailE-mailadres valideren (RFC en MX)
validation.email.batchTot 25 e-mailadressen per call
validation.email.disposableDisposable-domeincheck
validation.ibanIBAN en BIC valideren, offline
validation.vatBtw-nummer via VIES
validation.dnsblIP tegen vijf DNS-blacklists
lookup.dns.nameserversNameservers van een domein
lookup.dns.recordsDNS-records per type
lookup.ipIP-locatie en ISP
scraping.emailE-mailadressen uit HTML halen

De actuele lijst vraag je op met tools/list. Dat mag zonder sleutel.

Documentatie

Registervermeldingen

Lokaal draaien vanaf bron

Deze repository bevat ook een stdio-variant die de OpenAPI-specificatie elk uur opnieuw inleest. Die is bedoeld voor lokaal gebruik en voor eigen tooling.

npm install

npm run build API_KEY="ga_live_..." node dist/bin.js

Verschillen met het hosted endpoint:

  • Transport is stdio, geen URL en geen header. De sleutel gaat via de omgevingsvariabele API_KEY.
  • Toolnamen krijgen een getapi_-prefix en punten worden underscores: kadaster.bag.address heet lokaal getapi_kadaster_bag_address.
  • x402-endpoints worden niet als tool geëxporteerd.
  • De sleutel wordt uit logs en tool-output geredigeerd en gaat alleen mee in de header naar api.getapi.nl.

Het npm-pakket getapi-mcp is nog niet gepubliceerd, dus npx getapi-mcp werkt voorlopig niet. Gebruik tot die tijd het hosted endpoint hierboven of de broncode.

Configuratiewaarden

Deze staan vast in de server; alleen API_KEY is een omgevingsvariabele.

OptieDefaultOmschrijving
specUrlhttps://api.getapi.nl/docs/api.jsonOpenAPI-specificatie
baseUrlhttps://api.getapi.nlBasis-URL voor API-verzoeken
authHeaderX-Api-KeyHeadernaam voor auth
refreshIntervalMs3600000Interval voor de spec-check
timeoutMs10000Request-timeout
maxResponseSize1048576Maximale responsgrootte
maxSpecSize5242880Maximale specgrootte
x402ExcludedOperationsleegOperation-IDs die geen tool worden

Foutcodes

CodeOorzaakOplossing
401Sleutel ontbreekt of is ongeldigSleutel in de header of in API_KEY
400Fout in parametersParameters tegen de inputSchema leggen
404Onbekend endpoint of verkeerde parametersURL en parameters controleren
422ValidatiefoutParametertypes controleren
503API tijdelijk niet beschikbaarLater opnieuw proberen
TIMEOUTRequest duurde te langTimeout verhogen

Ontwikkelen en testen

npm install

Typecheck, lint, build en tests (unit en e2e)

npm run validate

Alles, inclusief documentatiecheck en smoke-test van het npm-pakket

npm run verify

npm test # alleen de tests npm run test:coverage # met coverage-drempels npm run check:docs # links, ankers, versies en configuratiewaarden npm run test:package # pakt, installeert en start het echte pakket API_KEY=ga_test_... npm run test:live # contracttest tegen de echte API

CI draait deze checks op elke push en pull request (.github/workflows/ci.yml) en vóór publicatie (.github/workflows/release.yml).

Handmatig controleren van de stdio-server: start hem en stuur JSON-RPC op stdin.

API_KEY="ga_test_1234567890" node dist/bin.js
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"cli","version":"1.0.0"}}}

Alle logregels gaan naar stderr; stdout bevat uitsluitend JSON-RPC.

Licentie

MIT, zie LICENSE.

Support

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