Skip to main content
Glama
tenderapi-mcp

tenderapi-mcp

by IDNSIDNS

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/mcp

Claude 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-mcp

Get 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.

Related MCP server: mcp-french-public-procurement

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

search_renewals

Pro

—

Contracts reaching their declared end date (DECP), i.e. coming back to tender in 3-18 months, with current holder

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.

Available Tools

4 tools
meAInspect

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

    A3.9/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency2/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 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.
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables agents to inspect French public procurement sources, including DECP, BOAMP, buyers, suppliers, and SIRENE data, to discover and summarize public contracts and related context.
      5
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      4
      MIT