Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Nl MCP

de GetApiNLversión 1.0.0i★ 0iSe ejecuta en la nube
Nombre en el registronl.getapi/mcp

Cómo instalar

What it does

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

  • Connects Se ejecuta en la nube
  • Account or key Works without a key · add X-Api-Key if you have one (often raises limits)
  • Category Otros

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 4/4 revisiones · Lo que preguntas pasa por el servidor del autor (api.getapi.nl) · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreNl MCP
    Remote MCP server URL · Direcciónhttps://api.getapi.nl/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsNl MCP

  4. Pruébalo

    Usa Nl MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Nl MCP o muestra una herramienta de Nl MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreNl MCP
    Connection · Direcciónhttps://api.getapi.nl/mcp
  3. Elige Nl MCP en un chat

    Abre un chat nuevo y elige Nl MCP en tus plugins antes de escribir

  4. Pruébalo

    Usa Nl MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando Nl MCP o muestra una herramienta de Nl MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user getapi https://api.getapi.nl/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver Nl MCP en la lista como conectado

  4. Pruébalo

    Usa Nl MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Nl MCP o muestra una herramienta de Nl MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa Nl MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Nl MCP o muestra una herramienta de Nl MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa Nl MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Nl MCP o muestra una herramienta de Nl MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://api.getapi.nl/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Nl MCP💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la 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"
    }
  }
}

Valores que debes completar

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

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Dominio verificado
✓ getapi.nl
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
1.0.0
Categoríai
Otros
Publicado en el registroi
17 oct 2026
Último cambio de códigoi
13 nov 2026
Creador
GetApiNL
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 13 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • 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 (

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 14 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con el dominio getapi.nl (el registro comprueba quién es dueño del dominio)

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: ayer

  • – No aplica

    Tiene licencia

    No aplica: servidor en la nube del propio dueño de getapi.nl; no ejecutas código del repo

  • ✓ Superada

    El endpoint responde

    Respondió en 753 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 33 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Otrosi

  • Más estrellas que el 0% de los otros 19709 servidores de esta categoría
  • Publicado en el registro más recientemente que el 60% de los otros 19709 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 19709 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Nl MCP?

Superó 4 de 4 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (1.0.0) llegó al registro hace 28 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, Claude Flow, Windmill

Otros de la misma categoría

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

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

de koala73Muy usado★ 90,6 milActualizado ayer

Se ejecuta en la nube✓ del servicio · worldmonitor.app

Claude Flow

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

de ruvnetMuy usado↓ 13,5 mil/sem★ 81,6 milActualizado hace 14 meses

Se ejecuta en tu computadora

Windmill

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

de windmill-labsMuy usado★ 18,6 milActualizado anteayer

Se ejecuta en la nube

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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.