Vektis MCP
This server lets you query the public Dutch AGB-register via MCP to find and inspect healthcare providers, organisations and locations.
Search individual care providers (
agb_search_zorgverleners) by AGB-code or name, filtered by zorgsoort, kwalificaties and active status.Search organisations and locations (
agb_search_organisaties) by code, name, plaats, postcode, KvK-nummer, zorgsoort and kwalificaties.Fetch full registration details (
agb_get_record) including basisregistratie, contact, kwalificaties, erkenningen, relaties and status.Look up code tables (
agb_lookup_codes) for zorgsoort and kwalificatie codes and labels, offline.Handle ambiguous or inactive records gracefully with candidates and einddatum/status information.
Use it from MCP clients such as Claude Desktop, Claude Code, Cursor, VS Code or Windsurf over stdio or HTTP, without an API key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Vektis MCP Find dental practices with postcode 9403 and list their KvK-nummer."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Vektis MCP
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-mcpOther clients use the same command and args under their own top-level key:
Client | File | Key |
Cursor |
|
|
VS Code |
|
|
Windsurf |
|
|
git clone https://github.com/pooryam92/vektis-mcp
cd vektis-mcp
uv sync
uv run vektis-mcpIn 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/mcpThe 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 |
| Individual care providers by AGB-code or name, filtered by zorgsoort and kwalificaties |
| Ondernemingen and vestigingen by code or name, plus plaats, postcode and kvknummer |
| One exact registration with optional sections: basisregistratie, contact, kwalificaties, erkenningen, relaties |
| 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 |
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. |
Kwalificatie | Four-digit qualification under a zorgsoort, e.g. |
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 |
|
| Minimum interval between requests to vektis.nl |
|
| Per-request timeout |
|
| Total budget per tool call, including pacing and retries |
|
| Retries after the first attempt |
| 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_errortool errors, never as empty results.The register renders at most 500 rows per search.
source_truncatedin 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-mcpThe 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 toolsagb_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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Look up US healthcare providers and organisations by NPI.
Validate, look up and count US NPI providers from the public CMS registry; not affiliated with CMS.
UK NHS organisations (ODS) and Charity Commission register lookups
Look up U.S. healthcare providers by NPI, name, specialty and ZIP radius from CMS NPPES data.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables 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.-
- AlicenseAqualityCmaintenanceEnables lookup, search, browsing, and explanation of WHO's International Classification of Functioning, Disability and Health (ICF) codes and qualifiers via the WHO ICD-API.171MIT
- AlicenseNot gradedqualityBmaintenanceEnables searching, viewing metadata, and querying tabular resources from Netherlands Open Data (data.overheid.nl) via CKAN.101 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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 npmMIT