SIMAP MCP Server

NPM Downloads

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.

License

MIT

SIMAP MCP Server

SIMAP MCP Server

Features

Installation

Quick start with npx (recommended)

Claude Code (CLI)

Claude Desktop

Global install

From source

Usage

Reference

`search_tenders`

`get_tender_details`

`search_cpv_codes` / `search_bkp_codes` / `search_npk_codes` / `search_oag_codes`

`browse_cpv_tree` / `browse_bkp_tree` / `browse_npk_tree` / `browse_oag_tree`

`list_cantons`

`list_institutions`

`get_publication_history`

`search_proc_offices`

Enums

Development

Project Structure

Listed on

Contributing

SIMAP API

License

관련 서버

o3 Search

Tavily

招投标大数据服务

Releasebot

Brave Search

Source Library

Naver Directions

Glean

MCP-SearXNG-Enhanced Web Search

Unsplash MCP Server

SIMAP MCP Server

SIMAP MCP Server

Features

Installation

Quick start with npx (recommended)

Claude Code (CLI)

Claude Desktop

Global install

From source

Usage

Reference

search_tenders

get_tender_details

search_cpv_codes / search_bkp_codes / search_npk_codes / search_oag_codes

browse_cpv_tree / browse_bkp_tree / browse_npk_tree / browse_oag_tree

list_cantons

list_institutions

get_publication_history

search_proc_offices

Enums

Development

Project Structure

Listed on

Contributing

SIMAP API

License

관련 서버

o3 Search

Tavily

招投标大数据服务

Releasebot

Brave Search

Source Library

Naver Directions

Glean

MCP-SearXNG-Enhanced Web Search

Unsplash MCP Server

`search_tenders`

`get_tender_details`

`search_cpv_codes` / `search_bkp_codes` / `search_npk_codes` / `search_oag_codes`

`browse_cpv_tree` / `browse_bkp_tree` / `browse_npk_tree` / `browse_oag_tree`

`list_cantons`

`list_institutions`

`get_publication_history`

`search_proc_offices`