io.github.IDNSIDNS/tenderapi-mcp
MCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http tenderapi-mcp 'https://tenderapi.fr/mcp'{
"mcpServers": {
"tenderapi-mcp": {
"type": "http",
"url": "https://tenderapi.fr/mcp"
}
}
}tenderapi-mcpclaude mcp add tenderapi-mcp -e 'TENDERAPI_KEY=<your tenderapi_key>' -e 'TENDERAPI_BASE_URL=https://tenderapi.fr' -- uvx tenderapi-mcp==0.9.0{
"mcpServers": {
"tenderapi-mcp": {
"command": "uvx",
"args": [
"tenderapi-mcp==0.9.0"
],
"env": {
"TENDERAPI_KEY": "<your tenderapi_key>",
"TENDERAPI_BASE_URL": "https://tenderapi.fr"
}
}
}
}Variables d'environnement
TENDERAPI_KEYobligatoire secret TenderAPI key (get a free one at https://tenderapi.fr/). Sent as X-API-Key header on every REST call.TENDERAPI_BASE_URLOverride the API base URL (default: https://tenderapi.fr). Useful for dev/staging.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
TenderAPI MCP server
Expose TenderAPI (French BOAMP + EU TED public procurement data) as MCP tools for AI agents (Claude Desktop, Cursor, Continue, Zed, etc.).
A thin wrapper over the public REST API at https://tenderapi.fr.
Coverage: BOAMP (France) since March 2015, and TED for FR/DE/IT/ES/UK since 2015 (legacy XML format until end 2023, then eForms), refreshed daily.
Two ways to use it
1. Hosted server — no install, no key
The fastest way to try it. Point any MCP client at the hosted endpoint:
https://tenderapi.fr/mcpClaude Desktop / Claude Code:
{
"mcpServers": {
"tenderapi": {
"type": "streamable-http",
"url": "https://tenderapi.fr/mcp"
}
}
}Exposes search_tenders and get_tender. Anonymous, free, limited to 30 tool calls per day per IP. No account, nothing to install.
Awards, winner intelligence and alert profiles are not available anonymously — they need a key, see below.
2. Local server (pip) — full toolset
Requires Python 3.10+ and a free API key.
pip install tenderapi-mcpGet a free key at https://tenderapi.fr/ (includes one weekly email watch), then:
{
"mcpServers": {
"tenderapi": {
"command": "tenderapi-mcp",
"env": {
"TENDERAPI_KEY": "ta_your_key_here"
}
}
}
}Claude Desktop config location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Restart the client. The tenderapi server should appear in the tool picker.
From source instead of PyPI:
git clone https://github.com/IDNSIDNS/tenderapi-mcp
cd tenderapi-mcp
pip install -e .Any MCP client supporting stdio transport works. The tenderapi-mcp binary installed by pip is the entry point.
Tools exposed
| Tool | Tier | Hosted (keyless) | Description |
|---|---|---|---|
search_tenders | Free | ✅ | Search BOAMP + TED tenders with typed filters (CPV, region, budget, deadline, source, etc.) |
get_tender | Free | ✅ | Fetch a single tender by id |
search_awards | Pro | — | Search award notices (who won which contract, for how much) |
get_award | Pro | — | Fetch a single award by id |
winner_intel | Pro | — | Aggregated winner stats: top companies by CPV / region / year |
me | any | — | Current key tier, quota remaining, available features |
list_profiles, get_profile, create_profile, update_profile, delete_profile | Free (1, weekly email) / Pro | — | Manage alert profiles for new-tender matches: weekly email on a free key; daily email digest, Teams card or webhook on Pro |
upgrade_tier, billing_portal | any | — | Stripe checkout and billing-management links |
PINs (prior-information notices) are excluded from search_tenders by default; pass include_planning=true to include them. A deadline_after/deadline_before filter drops notices with no submission deadline unless include_null_deadline=true.
Tiers
- Hosted, keyless: 30 tool calls/day per IP, tenders only
- Free key: tenders, 1 alert profile (email digest every Monday, to the account address)
- Pro (15 €/month): adds awards and winner intelligence, up to 10 alert profiles delivered every morning (email digest, Teams or webhook)
Request limits only protect the service (free: 1 000/day and 30/min; Pro: 1 500/day and 120/min); paginated lists stop at row 1 000.
Prices are final — no VAT is charged (art. 293 B French tax code). See https://tenderapi.fr/#pricing.
Local development
Override the API base URL via TENDERAPI_BASE_URL (default https://tenderapi.fr).
Requirements
Pinned to the mcp 1.x line: version 2.0.0 removed mcp.server.fastmcp, which this
server is built on. Migration to the 2.x API is tracked separately.
License
MIT, see LICENSE.
Questions fréquentes
Qu'est-ce que io.github.IDNSIDNS/tenderapi-mcp ?
MCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.
Comment installer io.github.IDNSIDNS/tenderapi-mcp ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http tenderapi-mcp 'https://tenderapi.fr/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.IDNSIDNS/tenderapi-mcp ?
Oui. Il attend TENDERAPI_KEY, à renseigner dans sa configuration.
io.github.IDNSIDNS/tenderapi-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.IDNSIDNS/tenderapi-mcp ?
Il est publié par IDNSIDNS. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.