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

Installation

Quick start with npx (recommended)

No installation needed — just configure your MCP client to use npx:

Claude Code (CLI)

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "simap": {
      "command": "npx",
      "args": ["-y", "@digilac/simap-mcp"]
    }
  }
}

Claude Desktop

Add to your Claude Desktop configuration file:

{
  "mcpServers": {
    "simap": {
      "command": "npx",
      "args": ["-y", "@digilac/simap-mcp"]
    }
  }
}

Global install

npm install -g @digilac/simap-mcp

Then configure with the direct command:

{
  "mcpServers": {
    "simap": {
      "command": "simap-mcp"
    }
  }
}

From source

git clone https://github.com/Digilac/simap-mcp.git
cd simap-mcp
npm install
npm run build

{
  "mcpServers": {
    "simap": {
      "command": "node",
      "args": ["/absolute/path/to/simap-mcp/dist/index.js"]
    }
  }
}

Usage

Once configured, simply ask Claude:

Search today's tenders:

"Show me new tenders published today"

Filter by type and canton:

"Find construction tenders in canton Vaud"

Get details:

"Give me the details of this tender" (after a search)

Keyword search:

"Find public contracts related to IT in Geneva"

Find CPV codes:

"Search CPV codes for IT services"

Browse code hierarchies:

"Show root CPV categories" "Show subcategories of CPV code 72000000"

Search construction codes:

"Search BKP codes for masonry"

View project history:

"Show me the publication history of this project"

Search procurement offices:

"Find procurement offices in the city of Zurich"

Reference

search_tenders

Search public tenders.

Parameter	Type	Description
search	string	Search text (min 3 characters)
publicationFrom	date	Start date (YYYY-MM-DD)
publicationUntil	date	End date (YYYY-MM-DD)
projectSubTypes	array	Project types (see below)
cantons	array	Canton codes (BE, VD, GE, ZH, etc.)
processTypes	array	Process types (see below)
pubTypes	array	Publication types (see below)
cpvCodes	array	CPV codes (8 digits, e.g., 72000000)
bkpCodes	array	BKP construction codes (e.g., 211)
issuedByOrganizations	array	UUIDs of issuing organizations
lastItem	string	Pagination token for next page
lang	string	Language: de, fr, it, en (default: en)

get_tender_details

Get tender details.

Parameter	Type	Description
projectId	uuid	Project ID
publicationId	uuid	Publication ID
lang	string	Preferred language

search_cpv_codes / search_bkp_codes / search_npk_codes / search_oag_codes

Search nomenclature codes by keyword or number.

Parameter	Type	Description
query	string	Search term (keyword or code prefix)
lang	string	Language: de, fr, it, en (default: en)

browse_cpv_tree / browse_bkp_tree / browse_npk_tree / browse_oag_tree

Navigate code hierarchies.

Parameter	Type	Description
parentCode	string	Parent code (optional, omit for root categories)
lang	string	Language: de, fr, it, en (default: en)

list_cantons

List all Swiss cantons with their codes. No parameters required.

list_institutions

List Swiss public institutions that publish tenders.

Parameter	Type	Description
search	string	Filter by name (min 3 characters, optional)
lang	string	Language: de, fr, it, en (default: en)

get_publication_history

Get the publication history for a project.

Parameter	Type	Description
publicationId	uuid	Current publication ID
lotId	uuid	Lot ID (optional, to filter by lot)

search_proc_offices

Search public procurement offices.

Parameter	Type	Description
search	string	Name to search (min 3 characters)
institutionId	uuid	Filter by parent institution (optional)

Enums

Code	Description
construction	Construction works
service	Services
supply	Supplies
project_competition	Project competitions
idea_competition	Idea competitions
overall_performance_competition	Overall performance competitions
project_study	Project studies
idea_study	Idea studies
overall_performance_study	Overall performance studies
request_for_information	Requests for information

Code	Description
open	Open procedure
selective	Selective procedure
invitation	Invitation procedure
direct	Direct award
no_process	No procedure (e.g., RFI)

Code	Description
advance_notice	Advance notice
request_for_information	Request for information
tender	Tender
competition	Competition
study_contract	Study contract
award_tender	Award (tender)
award_study_contract	Award (study)
award_competition	Award (competition)
direct_award	Direct award
participant_selection	Participant selection
selective_offering_phase	Selective offering phase
correction	Correction
revocation	Revocation
abandonment	Abandonment

AG, AI, AR, BE, BL, BS, FR, GE, GL, GR, JU, LU, NE, NW, OW, SG, SH, SO, SZ, TG, TI, UR, VD, VS, ZG, ZH

Development

npm run build          # Compile TypeScript
npm start              # Run the server
npm run dev            # Build + run
npm test               # Run tests
npm run lint           # Lint code
npm run format         # Format code

Project Structure

simap-mcp/
├── src/
│   ├── index.ts                  # Entry point
│   ├── server.ts                 # MCP server configuration
│   ├── api/
│   │   ├── client.ts             # SIMAP HTTP client
│   │   └── endpoints.ts          # Endpoint constants
│   ├── tools/
│   │   ├── search-tenders.ts
│   │   ├── get-tender-details.ts
│   │   ├── codes/                # Nomenclature tools (CPV, BKP, NPK, OAG)
│   │   └── organizations/        # Institution & procurement office tools
│   ├── types/                    # TypeScript interfaces
│   └── utils/                    # Translation & formatting helpers
├── tests/
├── dist/                         # Compiled output
└── package.json

Contributing

Contributions are welcome! See CONTRIBUTING.md to get started.

SIMAP API

This server uses the public API from SIMAP.ch.

License

MIT