MCP server for simap.ch - Swiss public procurement platform
io.github.Digilac/simap-mcp β MCP Server for simap.ch
The io.github.Digilac/simap-mcp server is an MCP (Model Context Protocol) server for simap.ch, described as the Swiss public procurement platform. It is distributed under the project topics including procurement, tenders, and switzerland, with implementation noted in nodejs and typescript.
π οΈ Key Features
MCP server for simap.ch (Swiss public procurement platform)
Focus on procurement and tenders context
π Use Cases
Providing model context for Swiss public procurement content
Supporting retrieval or analysis of tender-related information
Search tenders with filters (text, dates, types, cantons, CPV)
get_tender_details
Get full details of a specific tender
search_cpv_codes
Search CPV codes (Common Procurement Vocabulary)
browse_cpv_tree
Navigate CPV code hierarchy
list_cantons
List all Swiss cantons
list_institutions
List Swiss public institutions
get_publication_history
Get publication history for a project
search_proc_offices
Search public procurement offices
search_bkp_codes
Search BKP codes (construction)
browse_bkp_tree
Navigate BKP code hierarchy
search_npk_codes
Search NPK codes (standardized positions)
browse_npk_tree
Navigate NPK code hierarchy
search_oag_codes
Search OAG codes (object types)
browse_oag_tree
Navigate OAG code hierarchy
Prompt
Description
analyze_tender
Structured bid/no-bid analysis of a tender (scope, deadlines, eligibility, award criteria, risks)
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:
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:
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
Claude Code, Cursor, VS Code, Windsurf
They all take the same snippet β only the file and the top-level key change:
Client
Where
Top-level key
Claude Code
claude mcp add simap -- npx -y @digilac/simap-mcp
mcpServers
Cursor
~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project)
mcpServers
VS Code (Copilot)
.vscode/mcp.json, or the MCP: Open User Configuration command
Claude Code β add --scope user to enable it in every project, or --scope project to write a .mcp.json shared with your team. Claude Code does not read mcpServers from settings.json. Verify with claude mcp list.
VS Code uses servers as the top-level key, not mcpServers.
Cursor loads MCP servers only at startup β quit and reopen it fully.
Alternative: global install
bash
npm install -g @digilac/simap-mcp
Then point your client at the command directly:
json
{"mcpServers":{"simap":{"command":"simap-mcp"}}}
Alternative: from source
bash
git clone https://github.com/Digilac/simap-mcp.git
cd simap-mcp
npm install
npm run build
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.
Contributions are welcome! See CONTRIBUTING.md for development setup and commands, and ARCHITECTURE.md for architecture, internal patterns, and the full tool parameter reference.