io.github.Digilac/simap-mcp
MCP server for SIMAP.ch - Swiss public procurement platform
Ask AI about io.github.Digilac/simap-mcp
Powered by Claude · Grounded in docs
I know everything about io.github.Digilac/simap-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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
Project Types (projectSubTypes)
| 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 |
Process Types (processTypes)
| Code | Description |
|---|---|
open | Open procedure |
selective | Selective procedure |
invitation | Invitation procedure |
direct | Direct award |
no_process | No procedure (e.g., RFI) |
Publication Types (pubTypes)
| 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 |
Swiss Cantons
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
Listed on
Contributing
Contributions are welcome! See CONTRIBUTING.md to get started.
SIMAP API
This server uses the public API from SIMAP.ch.