Skip to main content
Glama

Vektis MCP

Python 3.12+ MCP License: MIT

MCP server for the public AGB-register of Vektis: search Dutch healthcare providers, practices and locations by AGB-code, name, zorgsoort, place or postcode, and read a full registration with its kwalificaties, erkenningen and relations. No API key, no account.

Unofficial. This project is not affiliated with or endorsed by Vektis. Every tool call reads the public register live; nothing is stored.

Voor Nederlandse gebruikers: zoek zorgverleners, ondernemingen en vestigingen in het AGB-register vanuit Claude, Cursor of een andere MCP-client. Stel vragen in het Nederlands; de veldnamen in de antwoorden zijn dezelfde als op vektis.nl.

Quick start

You need uv and internet access. The package is not on PyPI yet, so uvx installs it straight from GitHub.

Claude Desktop: add to claude_desktop_config.json and restart.

{
  "mcpServers": {
    "vektis": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/pooryam92/vektis-mcp", "vektis-mcp"]
    }
  }
}

Claude Code:

claude mcp add vektis -- uvx --from git+https://github.com/pooryam92/vektis-mcp vektis-mcp

Other clients use the same command and args under their own top-level key:

Client

File

Key

Cursor

~/.cursor/mcp.json

mcpServers

VS Code

.vscode/mcp.json

servers (add "type": "stdio")

Windsurf

~/.codeium/windsurf/mcp_config.json

mcpServers

git clone https://github.com/pooryam92/vektis-mcp
cd vektis-mcp
uv sync
uv run vektis-mcp

In a client config, point command at uv with "args": ["--directory", "/absolute/path/to/vektis-mcp", "run", "vektis-mcp"]. pip install . followed by vektis-mcp, or python -m vektis_mcp, works too.

uvx --from git+https://github.com/pooryam92/vektis-mcp vektis-mcp --transport streamable-http --host 127.0.0.1 --port 8000
claude mcp add --transport http vektis http://127.0.0.1:8000/mcp

The server binds to localhost. Before exposing it further, put HTTPS, authentication, Origin validation and request limits in front of it. Run one process: request pacing is per process.

Related MCP server: ICF MCP Server

Example prompts

  • "Zoek huisartsenpraktijken in Assen."

  • "Wat is AGB-code 01000451 en is die nog actief?"

  • "Welke zorgverleners werken bij vestiging 71001001?"

  • "Geef de contactgegevens en erkenningen van onderneming 01010001."

  • "Find dental practices with postcode 9403 and list their KvK-nummer."

  • "Which kwalificatie codes exist for zorgsoort 01?"

A typical flow is search, then agb_get_record with the record_type from the result. Search results are candidates, not confirmed identities.

Tools

Tool

What it does

agb_search_zorgverleners

Individual care providers by AGB-code or name, filtered by zorgsoort and kwalificaties

agb_search_organisaties

Ondernemingen and vestigingen by code or name, plus plaats, postcode and kvknummer

agb_get_record

One exact registration with optional sections: basisregistratie, contact, kwalificaties, erkenningen, relaties

agb_lookup_codes

Zorgsoort and kwalificatie codes by code or label, offline

The code tables are also served as the resource vektis://codes/{side}. Full parameter and response semantics are in docs/tools.md.

Terminology

Term

Meaning

AGB-code

Eight-digit identifier, leading zeros included. People and businesses can share a 01 prefix, so a code alone is not always unique across types.

Zorgverlener

An individual care provider (huisarts, tandarts, fysiotherapeut, ...). Search shows initials only and no address.

Onderneming

The legal entity: a practice, hospital or company.

Vestiging

A location of an onderneming. Its code appears only in the page URL, never on the page itself.

Zorgsoort

Two-digit care category, e.g. 01 huisartsen.

Kwalificatie

Four-digit qualification under a zorgsoort, e.g. 0101 huisarts.

Erkenning

A recognition such as a BIG or KvK registration or a WTZA notification.

Configuration

All optional, set as environment variables (the env block of a client config).

Variable

Default

Purpose

VEKTIS_REQUEST_INTERVAL_SECONDS

1.0

Minimum interval between requests to vektis.nl

VEKTIS_HTTP_TIMEOUT_SECONDS

20

Per-request timeout

VEKTIS_TOOL_DEADLINE_SECONDS

60

Total budget per tool call, including pacing and retries

VEKTIS_MAX_RETRIES

2

Retries after the first attempt

VEKTIS_USER_AGENT

a generic Chrome string

User-Agent sent to Vektis

Bad values fail at startup. By default the client sends the headers of an ordinary browser visit, so the traffic does not stand out; set VEKTIS_USER_AGENT if you want to identify your deployment instead.

Data source and limits

  • The source is the public register at vektis.nl, read as HTML. There is no official API behind this server, so a site redesign can break parsing; such failures surface as parse_error tool errors, never as empty results.

  • The register renders at most 500 rows per search. source_truncated in the response tells you the cap was hit; narrow the search by zorgsoort, plaats or postcode.

  • Requests are paced and retried with backoff to stay polite to Vektis. One tool call is one to four live requests.

  • The register contains names and contact details of care professionals. Use the data within Vektis's terms of use and applicable privacy law.

  • Only the AGB-register is covered today. Other public Vektis sources are listed in ROADMAP.md.

Development

uv sync
uv run pytest -q
npx @modelcontextprotocol/inspector uv run vektis-mcp

The test suite runs fully offline against synthetic fixtures. How the server is built is described in docs/design.md; what the live site does, field by field, in docs/agb-source-notes.md.

License

MIT for the code, see LICENSE. The register data belongs to Vektis and is subject to the terms of use on vektis.nl.

More Dutch extensions

For more Dutch extensions for your AI, see qontex.nl.

Available Tools

4 tools
agb_get_recordA

Retrieve one exact AGB registration, preserving leading zeros.

Return found, not_found or ambiguous. For ambiguous, return candidates to retry with record_type. A found record includes identity, status, source_url and retrieved_at. Source failures are tool errors, never not_found responses.

Inputs: agbcode (required), sections, record_type. Returns: record, outcome, candidates

agb_lookup_codesA

Discover zorgsoort and kwalificatie filter codes and labels.

Without filters, list zorgsoorten. With zorgsoort, list its kwalificaties. With query alone, search both levels. With both, search kwalificaties under that zorgsoort. Each kwalificatie includes its parent_code. Unknown parents are input errors; an unmatched query returns an empty results list.

Inputs: entity_kind (required), query, zorgsoort. Returns: results, entity_kind

agb_search_organisatiesA

Search the AGB-register for ondernemingen (businesses) and vestigingen (locations).

Require at least one non-empty query, location, KvK, zorgsoort or kwalificatie criterion. Results include record_type and an address when available.

Inputs: limit, query, plaats, postcode, +4 more. Returns: results, has_more, source_total, returned_count, +2 more

agb_search_zorgverlenersA

Search the AGB-register for individual zorgverleners (huisartsen, tandartsen, fysiotherapeuten, ...).

Results carry initials-only names and no address; use agb_get_record for detail sections.

Inputs: query (required), limit, zorgsoort, include_ended, +1 more. Returns: results, has_more, source_total, returned_count, +2 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    The two search tools are cleanly split by target (zorgverleners individuals vs organisaties businesses/locations), agb_get_record is a distinct exact-retrieval operation, and agb_lookup_codes handles filter metadata. No two tools overlap in purpose.

    Naming Consistency5/5

    All four tools use a consistent agb_ prefix with a clear verb_noun/snake_case pattern (search_x, get_record, lookup_codes). Predictable and readable throughout.

    Tool Count5/5

    Four tools are well-scoped for a register-lookup service: two search entry points, one exact-get, one code-discovery helper. Each earns its place with no redundancy.

    Completeness5/5

    The read-only AGB domain is fully covered: search for individuals and organizations, exact record retrieval handling found/not_found/ambiguous, and code discovery for filters. No obvious operational gaps for a lookup surface.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables interaction with the CMS NPPES NPI Registry to search, lookup, and validate National Provider Identifier records. It features offline-capable search using a local SQLite database that automatically updates with the latest provider data.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables searching, viewing metadata, and querying tabular resources from Netherlands Open Data (data.overheid.nl) via CKAN.
      101 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to resolve an Australian Business Number or company number to its registered legal entity name, entity type, status, GST registration, address and business names, and to search the register for ranked matches by entity or business name. Uses the caller's own free Australian Business Register web-services GUID as an API key, so no shared credential is provided.
      82 npm
      MIT