qune-tech/ocds-mcp

Local MCP server for German public procurement search. Connects your AI assistant (Claude, GPT, etc.) to the Vergabe Dashboard API for semantic search, tender matching, and company-profile management.
**Your queries and company profiles never leave your machine.** They are embedded locally with a multilingual ONNX model; only the resulting embedding vectors, OCIDs, and filter values are sent to the API. Data minimisation by design.
> **Hosted alternative:** if you just want search from your AI assistant, there is a hosted MCP connector (OAuth sign-in, no installation) — see the setup guide. This local server is for running the client in your own environment: queries and profiles are embedded locally, only vectors and filter values leave the machine, and it unlocks API-key features.
> New to German public procurement? The Vergabe Dashboard knowledge base explains eForms, EU thresholds, and the tender lifecycle, and KI für Vergabe covers the hosted AI side of this server.
Quick Start
1. Get an API key
Sign up at vergabe-dashboard.qune.de and create an API key. API keys require an active **Pro plan** (€99/month; the local server itself is free and open source — the API gate rides key issuance).
2. Install
**Via npx** (easiest — downloads the correct binary automatically):
**Or download a pre-built binary** from GitHub Releases:
| Platform | Download |
|----------|----------|
| Linux x86_64 | vergabe-mcp-linux-x86_64.tar.gz |
| macOS Apple Silicon | vergabe-mcp-macos-arm64.tar.gz |
| Windows x86_64 | vergabe-mcp-windows-x86_64.zip |
**Linux / macOS:**
**Windows:** Extract the zip and move vergabe-mcp.exe somewhere on your PATH.
**Or build from source:**
3. Configure your AI client
**Claude Desktop** — edit claude_desktop_config.json:
Using npx:
Using the binary directly:
**Claude Code** — add .mcp.json to your project root:
Using npx:
Using the binary directly:
**Cursor** — Settings → MCP Servers → Add:
Using npx:
- Command: npx
- Args: -y @qune-tech/vergabe-mcp --api-key sk_live_YOUR_KEY_HERE
Using the binary directly:
- Command: vergabe-mcp
- Args: --api-key sk_live_YOUR_KEY_HERE
**LM Studio** — Settings → MCP → Add Server:
1. Click **+ Add Server** and choose **STDIO**
2. Fill in:
Using npx:
- Name: vergabe
- Command: npx
- Arguments: -y @qune-tech/vergabe-mcp --api-key sk_live_YOUR_KEY_HERE
Using the binary directly:
- Name: vergabe
- Command: full path to the binary, e.g. /usr/local/bin/vergabe-mcp
- Arguments: --api-key sk_live_YOUR_KEY_HERE
3. Click **Save**
4. In the chat, select a model that supports tool use and enable the vergabe server
> LM Studio requires models with tool-calling support (e.g. Qwen 2.5, Mistral, Llama 3.1+).
> Smaller models may not use all 11 tools reliably — 7B+ recommended.
Replace sk_live_YOUR_KEY_HERE with your actual API key. You can also pass the key via the VERGABE_API_KEY environment variable.
Available Tools (11)
| Tool | Description |
|------|-------------|
| search_text | Semantic search across all tenders (query embedded locally) |
| list_releases | Filter and browse tenders by phase, CPV prefix, country, value range, deadline, buyer, procurement method |