{
  "markdown": "# TenderAPI MCP server\n\n<!-- mcp-name: io.github.IDNSIDNS/tenderapi-mcp -->\n\nExpose TenderAPI (French BOAMP + EU TED public procurement data) as MCP tools for AI agents (Claude Desktop, Cursor, Continue, Zed, etc.).\n\nA thin wrapper over the public REST API at <https://tenderapi.fr>.\n\nCoverage: 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.\n\n## Two ways to use it\n\n### 1. Hosted server — no install, no key\n\nThe fastest way to try it. Point any MCP client at the hosted endpoint:\n\n```\nhttps://tenderapi.fr/mcp\n```\n\nClaude Desktop / Claude Code:\n\n```json\n{\n  \"mcpServers\": {\n    \"tenderapi\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://tenderapi.fr/mcp\"\n    }\n  }\n}\n```\n\nExposes `search_tenders` and `get_tender`. **Anonymous, free, limited to 30 tool calls per day per IP.** No account, nothing to install.\n\nAwards, winner intelligence and alert profiles are not available anonymously — they need a key, see below.\n\n### 2. Local server (pip) — full toolset\n\nRequires Python 3.10+ and a free API key.\n\n```bash\npip install tenderapi-mcp\n```\n\nGet a free key at <https://tenderapi.fr/> (100 requests/day), then:\n\n```json\n{\n  \"mcpServers\": {\n    \"tenderapi\": {\n      \"command\": \"tenderapi-mcp\",\n      \"env\": {\n        \"TENDERAPI_KEY\": \"ta_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nClaude Desktop config location:\n\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- Linux: `~/.config/Claude/claude_desktop_config.json`\n\nRestart the client. The `tenderapi` server should appear in the tool picker.\n\nFrom source instead of PyPI:\n\n```bash\ngit clone https://github.com/IDNSIDNS/tenderapi-mcp\ncd tenderapi-mcp\npip install -e .\n```\n\nAny MCP client supporting stdio transport works. The `tenderapi-mcp` binary installed by pip is the entry point.\n\n## Tools exposed\n\n| Tool | Tier | Hosted (keyless) | Description |\n|------|------|------------------|-------------|\n| `search_tenders` | Free | ✅ | Search BOAMP + TED tenders with typed filters (CPV, region, budget, deadline, source, etc.) |\n| `get_tender` | Free | ✅ | Fetch a single tender by id |\n| `search_awards` | Starter | — | Search award notices (who won which contract, for how much) |\n| `get_award` | Starter | — | Fetch a single award by id |\n| `winner_intel` | Pro | — | Aggregated winner stats: top companies by CPV / region / year |\n| `me` | any | — | Current key tier, quota remaining, available features |\n| `list_profiles`, `get_profile`, `create_profile`, `update_profile`, `delete_profile` | Starter | — | Manage alert profiles (daily email digest, Teams card, or webhook) for new-tender matches |\n| `upgrade_tier`, `billing_portal` | any | — | Stripe checkout and billing-management links |\n\nPINs (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`.\n\n## Tiers\n\n- **Hosted, keyless**: 30 tool calls/day per IP, tenders only\n- **Free key**: 100 req/day, tenders only\n- **Starter** (5 €/month): 500 req/day, adds awards + alert profiles (email digest, Teams or webhook)\n- **Pro** (15 €/month): 1 500 req/day, adds winner intelligence\n\nPrices are final — no VAT is charged (art. 293 B French tax code). See <https://tenderapi.fr/#pricing>.\n\n## Local development\n\nOverride the API base URL via `TENDERAPI_BASE_URL` (default `https://tenderapi.fr`).\n\n## Requirements\n\nPinned to the `mcp` 1.x line: version 2.0.0 removed `mcp.server.fastmcp`, which this\nserver is built on. Migration to the 2.x API is tracked separately.\n\n## License\n\nMIT, see [LICENSE](LICENSE).\n",
  "bytes": 3789,
  "sha": "ff9eb0280a44a8c6ca3606d7c48cf39fd84077bcaafacb481f87eeae967e5a55",
  "repo_slug": "idnsidns/tenderapi-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_idnsidns_tenderapi_mcp_c99e6aa6/readme"
}