simap MCP Server
An MCP server that lets AI assistants search and explore Swiss public procurement data on simap.ch.
Search public tenders with filters for text, dates, cantons, CPV/BKP codes, publication/process/project types, issuing organizations, language, and pagination.
Retrieve detailed information for a specific tender by project ID and optional publication ID, including the option to include the raw API response.
Get publication history for a project, including corrections, awards, and optional lot filtering.
Search and browse reference code hierarchies for CPV, BKP, NPK, and OAG codes.
List Swiss cantons and public institutions, and search procurement offices by name or institution.
Use the
analyze_tenderprompt for structured bid/no-bid analysis covering scope, deadlines, eligibility, award criteria, and risks.
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., "@simap MCP Server Search for IT tenders in Zurich"
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.
simap MCP Server
An MCP (Model Context Protocol) server for interacting with simap.ch, Switzerland's public procurement platform.
Enables Claude and other AI assistants to search and view public tenders in Switzerland.
Developed by Digilac.
Features
Tool | Description |
| Search tenders with filters (text, dates, types, cantons, CPV) |
| Get full details of a specific tender |
| Search CPV codes (Common Procurement Vocabulary) |
| Navigate CPV code hierarchy |
| List all Swiss cantons |
| List Swiss public institutions |
| Get publication history for a project |
| Search public procurement offices |
| Search BKP codes (construction) |
| Navigate BKP code hierarchy |
| Search NPK codes (standardized positions) |
| Navigate NPK code hierarchy |
| Search OAG codes (object types) |
| Navigate OAG code hierarchy |
Prompt | Description |
| Structured bid/no-bid analysis of a tender (scope, deadlines, eligibility, award criteria, risks) |
Related MCP server: simap
Prerequisites
An MCP-compatible client — Claude Desktop is the easiest if you are not a developer.
Node.js ≥ 22 — only for clients that do not bundle it. Claude Desktop ships with its own Node.js, so there is nothing to install. For every other client, get it from nodejs.org (pick the LTS version).
No simap account, no API key, no payment — the simap API is public and read-only.
Installation & Configuration
Claude Desktop (recommended)
In Claude Desktop, open Settings → Developer → Edit Config. This opens the folder holding
claude_desktop_config.json:macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Open that file in a text editor and paste the block below. If the file already contains an
mcpServerssection, add only the"simap"entry inside it.{ "mcpServers": { "simap": { "command": "npx", "args": ["-y", "@digilac/simap-mcp"] } } }Save the file, then fully quit Claude Desktop (macOS: ⌘Q — closing the window is not enough) and reopen it.
Check it worked: the simap tools now show up under the tools icon in the message box. Ask "List the Swiss cantons in simap" — Claude should answer with the 26 cantons.
The very first launch downloads the server, which takes a few seconds. If the tools do not appear, check Settings → Developer for the server status and logs.
LM Studio
LM Studio follows the same mcp.json notation. Open the Program tab in the right-hand sidebar, then Install → Edit mcp.json, and add:
{
"mcpServers": {
"simap": {
"command": "npx",
"args": ["-y", "@digilac/simap-mcp"]
}
}
}LM Studio does not bundle Node.js — install it from nodejs.org first. Tender search leans on the model's ability to chain tool calls, so results depend a lot on which local model you load.
Code editors & developer tools
They all take the same snippet — only the file and the top-level key change:
Client | Where | Top-level key |
Claude Code |
|
|
Cursor |
|
|
VS Code (Copilot) |
|
|
Windsurf |
|
|
{
"mcpServers": {
"simap": {
"command": "npx",
"args": ["-y", "@digilac/simap-mcp"]
}
}
}Claude Code — add
--scope userto enable it in every project, or--scope projectto write a.mcp.jsonshared with your team. Claude Code does not readmcpServersfromsettings.json. Verify withclaude mcp list.VS Code uses
serversas the top-level key, notmcpServers.Cursor loads MCP servers only at startup — quit and reopen it fully.
npm install -g @digilac/simap-mcpThen point your client at the command directly:
{
"mcpServers": {
"simap": {
"command": "simap-mcp"
}
}
}git clone https://github.com/Digilac/simap-mcp.git
cd simap-mcp
npm install
npm run buildThen point your client at the absolute path:
{
"mcpServers": {
"simap": {
"command": "node",
"args": ["/absolute/path/to/simap-mcp/dist/index.js"]
}
}
}Usage
Once configured, just ask your AI assistant in natural language. Mention "in simap" to make sure the assistant routes the request through the MCP server:
"Show me new tenders published today in simap"
"Find construction tenders in canton Vaud in simap"
"Give me the details of this tender in simap" (after a search)
"Search CPV codes for IT services in simap"
Clients that support MCP prompts also expose analyze_tender: in Claude Code, run /mcp__simap__analyze_tender <simap.ch link>; in Claude Desktop, pick it from the "+" menu and paste the tender's link.
Network behaviour
Rate limit: requests to simap.ch are throttled to 60 per minute; extra calls wait their turn instead of failing.
Caching: reference data (cantons, institutions, CPV/BKP/NPK/OAG codes) is cached in memory for 24 hours, so repeated lookups are instant and don't use up the rate limit. Tenders and organization lookups are always fetched live. The cache is cleared when the server restarts.
Retries: transient simap failures (HTTP 408 / 429 / 5xx, network errors) are retried up to 2 times with exponential backoff, honouring
Retry-After.
Listed on
Contributing
Contributions are welcome! See CONTRIBUTING.md for development setup and commands, and ARCHITECTURE.md for architecture, internal patterns, and the full tool parameter reference.
simap API
This server uses the public API from simap.ch.
License
Available Tools
14 toolsbrowse_bkp_treeBrowse BKP TreeBRead-onlyIdempotent
Browse the BKP code hierarchy (Swiss construction cost plan)
Inputs: lang, parentCode.
browse_cpv_treeBrowse CPV TreeBRead-onlyIdempotent
Browse the CPV code hierarchy (shows subcategories of a parent code)
Inputs: lang, parentCode.
browse_npk_treeBrowse NPK TreeCRead-onlyIdempotent
Browse the NPK code hierarchy (standardized positions catalog)
Inputs: lang, parentCode.
browse_oag_treeBrowse OAG TreeBRead-onlyIdempotent
Browse the OAG code hierarchy (object type classification)
Inputs: lang, parentCode.
get_publication_historyGet Publication HistoryBRead-onlyIdempotent
Get the publication history for a project (corrections, awards, etc.)
Inputs: publicationId (required), lotId.
get_tender_detailsGet Tender DetailsCRead-onlyIdempotent
Get detailed information about a specific tender
Inputs: projectId (required), lang, fullRaw, publicationId.
list_cantonsList CantonsARead-onlyIdempotent
List all Swiss cantons with their codes (useful for search filters)
Inputs: no named parameters.
list_institutionsList InstitutionsBRead-onlyIdempotent
List Swiss public institutions (Confederation, cantons, municipalities) that publish tenders
Inputs: lang, search.
search_bkp_codesSearch BKP CodesCRead-onlyIdempotent
Search BKP (Swiss construction cost plan) codes by keyword or number
Inputs: query (required), lang.
search_cpv_codesSearch CPV CodesBRead-onlyIdempotent
Search CPV (Common Procurement Vocabulary) codes by keyword or partial code number
Inputs: query (required), lang.
search_npk_codesSearch NPK CodesCRead-onlyIdempotent
Search NPK (standardized positions catalog) codes by keyword or number
Inputs: query (required), lang.
search_oag_codesSearch OAG CodesBRead-onlyIdempotent
Search OAG (object type classification) codes by keyword or number
Inputs: query (required), lang.
search_proc_officesSearch Procurement OfficesBRead-onlyIdempotent
Search public procurement offices by name or institution
Inputs: search, institutionId.
search_tendersSearch TendersCRead-onlyIdempotent
Search public tenders on simap.ch with filters by date, canton, CPV codes, and other criteria
Inputs: lang, search, cantons, bkpCodes, +8 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Each tool targets a distinct resource+action: search_tenders vs get_tender_details vs get_publication_history are clearly separated, and the four code systems (CPV, BKP, NPK, OAG) each have a clearly differentiated search_*_codes vs browse_*_tree pair. No two tools appear to do the same thing.
Uniform verb_noun snake_case throughout: search_*, browse_*, list_*, get_*. The code-system tools follow an identical template (search_X_codes / browse_X_tree), making the pattern highly predictable.
14 tools is well within a healthy range. The apparent repetition (four code systems x search+browse) is justified because each system is a genuinely different vocabulary an agent must query separately, and the remaining tools cover core tender workflows.
Strong read-only coverage: tender search, details, publication history, code lookups (search + hierarchy browse), institutions, cantons, and procurement offices. Minor gaps exist around fetching full tender documents/attachments or looking up a single code/institution by exact identifier, but core discovery workflows are complete.
Maintenance
Related MCP Connectors
simap MCP — Swiss public procurement tenders and awards (keyless).
Search public procurement notices from 17 sources across Germany, the EU and the UK. Read-only.
Free MCP tool for AI agents to search French public tenders and procurement opportunities using official BOAMP open data. Find notices by keyword, access source references, and verify tender details and deadlines.
Search EU, UK and US public tenders, look up award history, and get alerts on new matches.
Related MCP Servers
- AlicenseBqualityCmaintenanceProvides AI models with access to Ukrainian government procurement data from Prozorro, enabling search and retrieval of tender information by organization, date range, and other criteria.19 npm12ISC
- AlicenseNot gradedqualityCmaintenanceProvides access to Swiss public procurement tenders and awards data, queryable via natural language through the Pipeworx gateway.83 npmMIT
- AlicenseAqualityBmaintenanceMCP server providing read access to Swiss public procurement data via the official simap.ch API, covering all cantons and the Confederation with intraday updates. It enables searching tenders, awards, construction codes, and procurement offices through natural language queries.9MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search and retrieve public procurement notices from 17 sources across Germany, the EU, and the UK, with filtering by country, CPV code, deadline, and contract value, plus full tender details and source freshness checks.MIT