tenderapi-mcp
This MCP server exposes French (BOAMP) and EU (TED) public procurement data as tools, letting an AI agent search tenders, analyze award winners, and check API quota/tier.
search_tenders— paginated search of tender notices with filters: CPV code, French region, budget range, submission-deadline cutoff, source (boamp/ted), status (open/closed/awarded), buyer SIRET, and country.search_awards— find award notices (who won which contract, for how much) filtered by CPV, region, winner name/SIRET, award date, amount, and source (requires Starter tier or above).winner_intel— aggregated competitive intelligence: top winning companies by contract count and total amount, filtered by CPV, region, and year (requires Pro tier).me— check the key's tier, remaining quota, and available features so the agent can plan calls.The README additionally documents
get_tender,get_award,search_renewals, and alert-profile management (list/get/create/update/delete_profile), though these aren't in the supplied schema.Can run hosted (keyless, 30 calls/day, tenders only) or locally via
pip install tenderapi-mcpwith a free API key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tenderapi-mcp search tenders for IT services in Île-de-France"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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/BE/LU since 2015 (legacy XML format until end 2023, then eForms), refreshed daily. UK is covered up to 2020 only: it no longer publishes on TED since Brexit.
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, get_tender and preview_alerts (simulates an alert profile without creating it: real alert rate, sample titles, what each filter removes). 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.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.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.
Related MCP server: mcp-french-public-procurement
Tools exposed
Tool | Tier | Hosted (keyless) | Description |
| Free | ✅ | Search BOAMP + TED tenders with typed filters (CPV, region, budget, deadline, source, etc.) |
| Free | ✅ | Fetch a single tender by id |
| Pro | — | Search award notices (who won which contract, for how much) |
| Pro | — | Fetch a single award by id |
| Pro | — | Aggregated winner stats: top companies by CPV / region / year |
| Pro | — | Contracts reaching their declared end date (DECP), i.e. coming back to tender in 3-18 months, with current holder |
| any | — | Current key tier, quota remaining, available features |
| 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 |
| 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.
Available Tools
4 toolsmeAInspect
Return the authenticated key's tier, quota remaining, and available features.
Useful for the agent to check quota before launching many calls or to pick a tier-appropriate strategy.
Inputs: no named parameters. Returns: object
search_awardsAInspect
Search award notices — who won which public contract, for how much.
Requires Starter tier or above.
Args: cpv: CPV code filter. region: Region slug. winner_name: Partial match on the winning company name. winner_siret: Exact SIRET match (14 digits). awarded_after: ISO date; awards with an award date after this. amount_min: Minimum contract amount, EUR. source: "boamp" or "ted". page / page_size: Pagination.
Inputs: cpv, region, winner_name, winner_siret, +5 more. Returns: object
search_tendersAInspect
Search public procurement tenders from BOAMP (France) and TED (EU).
Returns a paginated list of tender notices matching the filters.
Args: cpv: CPV classification code (e.g. "72000000" for IT services). region: French region slug, lowercase (e.g. "occitanie", "ile-de-france", "bretagne"). budget_min: Minimum estimated budget, EUR. budget_max: Maximum estimated budget, EUR. deadline_after: ISO date (YYYY-MM-DD); only tenders with submission deadline after this date. source: "boamp" (France) or "ted" (EU-wide). Omit to include both. status: "open" | "closed" | "awarded". buyer_siret: Exact SIRET of the French contracting authority (14 digits). country: ISO 3-letter country code (default FR). page: 1-indexed page number. page_size: Results per page, 1-100.
Returns a dict with keys: total, page, page_size, results (list of tenders).
Inputs: cpv, region, budget_min, budget_max, +7 more. Returns: object
winner_intelAInspect
Aggregated winner statistics — top companies by contract count and total amount.
Requires Pro tier. Use for competitive intelligence: "which companies win IT contracts in Occitanie in 2025?".
Args: cpv: CPV code filter. region: Region slug. year: Integer year filter (e.g. 2025). limit: Top N results (default 10, max 50).
Inputs: cpv, region, year, limit. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: 'me' for account info, 'search_awards' for award notices, 'search_tenders' for procurement tenders, and 'winner_intel' for aggregated winner statistics. No overlap exists, making it easy for an agent to select the correct tool.
Tool names are inconsistent: 'me' is a single word without a verb, while 'search_awards' and 'search_tenders' follow a verb_noun pattern, and 'winner_intel' is a noun compound. This mixture of conventions (one-word, verb_noun, noun_noun) creates confusion and lacks a predictable pattern.
With only 4 tools, the server is well-scoped for its purpose of querying public procurement data. Each tool addresses a core need (account check, award search, tender search, winner analytics) without unnecessary bloat or missing essentials.
The tool set covers the main workflows for procurement data exploration: account info, searching awards and tenders, and winner statistics. However, a tool to retrieve full details of a specific tender or award by ID is missing, which is a minor gap but agents can work around it using search filters.
Related MCP Connectors
Free MCP tool for AI agents to search French public tenders and procurement opportunities using official BOAMP open data. Find notices by keyword, access source references, and verify tender details and deadlines.
EU & French tenders with AI summaries, company checks, product recalls - via official Apify MCP
TED MCP Server: Real-time EU public tenders access. https://www.lexsocket.ai/
Search EU, UK and US public tenders, look up award history, and get alerts on new matches.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides AI agents with access to French public registries including company records, property sale prices, housing energy performance, and short-term rental rates via MCP tools.-
- AlicenseBqualityBmaintenanceEnables agents to inspect French public procurement sources, including DECP, BOAMP, buyers, suppliers, and SIRENE data, to discover and summarize public contracts and related context.5MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search and retrieve public procurement notices from 17 sources across Germany, the EU, and the UK, with filtering by country, CPV code, deadline, and contract value, plus full tender details and source freshness checks.MIT
- AlicenseAqualityCmaintenanceEnables AI agents to search, count, and validate EU public-procurement notices from the Tenders Electronic Daily database through read-only, keyless queries using keyword, country, CPV, date-range, and expert-syntax filters. It can run locally over stdio or as a token-protected HTTPS connector, returning notice titles, buyers, values, and links.4MIT