English Français العربية

io.github.IDNSIDNS/tenderapi-mcp

السجل الرسمي أخرى

MCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http tenderapi-mcp 'https://tenderapi.fr/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "tenderapi-mcp": {
            "type": "http",
            "url": "https://tenderapi.fr/mcp"
        }
    }
}
PYPI package tenderapi-mcp
Claude Code 
claude mcp add tenderapi-mcp -e 'TENDERAPI_KEY=<your tenderapi_key>' -e 'TENDERAPI_BASE_URL=https://tenderapi.fr' -- uvx tenderapi-mcp==0.9.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "tenderapi-mcp": {
            "command": "uvx",
            "args": [
                "tenderapi-mcp==0.9.0"
            ],
            "env": {
                "TENDERAPI_KEY": "<your tenderapi_key>",
                "TENDERAPI_BASE_URL": "https://tenderapi.fr"
            }
        }
    }
}

متغيرات البيئة

  • TENDERAPI_KEY إلزامي سري TenderAPI key (get a free one at https://tenderapi.fr/). Sent as X-API-Key header on every REST call.
  • TENDERAPI_BASE_URL Override the API base URL (default: https://tenderapi.fr). Useful for dev/staging.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. TenderAPI MCP server
  2. Two ways to use it
  3. Tools exposed
  4. Tiers
  5. Local development
  6. Requirements
  7. License

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

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

Tools exposed

ToolTierHosted (keyless)Description
search_tendersFree✅Search BOAMP + TED tenders with typed filters (CPV, region, budget, deadline, source, etc.)
get_tenderFree✅Fetch a single tender by id
search_awardsPro—Search award notices (who won which contract, for how much)
get_awardPro—Fetch a single award by id
winner_intelPro—Aggregated winner stats: top companies by CPV / region / year
meany—Current key tier, quota remaining, available features
list_profiles, get_profile, create_profile, update_profile, delete_profileFree (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_portalany—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.

الأسئلة الشائعة

ما هو io.github.IDNSIDNS/tenderapi-mcp؟

MCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.

كيف أثبّت io.github.IDNSIDNS/tenderapi-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http tenderapi-mcp 'https://tenderapi.fr/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.IDNSIDNS/tenderapi-mcp إلى مفتاح API؟

نعم. يتطلب TENDERAPI_KEY، وتضبطها في إعداداته.

هل io.github.IDNSIDNS/tenderapi-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.IDNSIDNS/tenderapi-mcp؟

ينشره IDNSIDNS. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.