Skip to main content
Glama
simap MCP Server

simap MCP Server

by Digilac

simap MCP Server

GitHub License NPM Version GitHub Actions Workflow Status NPM Downloads Ask DeepWiki

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

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)

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

  1. 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.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Open that file in a text editor and paste the block below. If the file already contains an mcpServers section, add only the "simap" entry inside it.

    {
      "mcpServers": {
        "simap": {
          "command": "npx",
          "args": ["-y", "@digilac/simap-mcp"]
        }
      }
    }
  3. Save the file, then fully quit Claude Desktop (macOS: ⌘Q — closing the window is not enough) and reopen it.

  4. 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

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

servers

Windsurf

~/.codeium/windsurf/mcp_config.json

mcpServers

{
  "mcpServers": {
    "simap": {
      "command": "npx",
      "args": ["-y", "@digilac/simap-mcp"]
    }
  }
}
  • 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.

npm install -g @digilac/simap-mcp

Then 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 build

Then 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

MIT

Available Tools

14 tools
browse_bkp_treeBrowse BKP TreeB
Read-onlyIdempotent

Browse the BKP code hierarchy (Swiss construction cost plan)

Inputs: lang, parentCode.

browse_cpv_treeBrowse CPV TreeB
Read-onlyIdempotent

Browse the CPV code hierarchy (shows subcategories of a parent code)

Inputs: lang, parentCode.

browse_npk_treeBrowse NPK TreeC
Read-onlyIdempotent

Browse the NPK code hierarchy (standardized positions catalog)

Inputs: lang, parentCode.

browse_oag_treeBrowse OAG TreeB
Read-onlyIdempotent

Browse the OAG code hierarchy (object type classification)

Inputs: lang, parentCode.

get_publication_historyGet Publication HistoryB
Read-onlyIdempotent

Get the publication history for a project (corrections, awards, etc.)

Inputs: publicationId (required), lotId.

get_tender_detailsGet Tender DetailsC
Read-onlyIdempotent

Get detailed information about a specific tender

Inputs: projectId (required), lang, fullRaw, publicationId.

list_cantonsList CantonsA
Read-onlyIdempotent

List all Swiss cantons with their codes (useful for search filters)

Inputs: no named parameters.

list_institutionsList InstitutionsB
Read-onlyIdempotent

List Swiss public institutions (Confederation, cantons, municipalities) that publish tenders

Inputs: lang, search.

search_bkp_codesSearch BKP CodesC
Read-onlyIdempotent

Search BKP (Swiss construction cost plan) codes by keyword or number

Inputs: query (required), lang.

search_cpv_codesSearch CPV CodesB
Read-onlyIdempotent

Search CPV (Common Procurement Vocabulary) codes by keyword or partial code number

Inputs: query (required), lang.

search_npk_codesSearch NPK CodesC
Read-onlyIdempotent

Search NPK (standardized positions catalog) codes by keyword or number

Inputs: query (required), lang.

search_oag_codesSearch OAG CodesB
Read-onlyIdempotent

Search OAG (object type classification) codes by keyword or number

Inputs: query (required), lang.

search_proc_officesSearch Procurement OfficesB
Read-onlyIdempotent

Search public procurement offices by name or institution

Inputs: search, institutionId.

search_tendersSearch TendersC
Read-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

    A3.5/5.0

    Scored across 14 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides access to Swiss public procurement tenders and awards data, queryable via natural language through the Pipeworx gateway.
      83 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP 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.
      9
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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