tenderapi-mcp 0.1.0__py3-none-any.whl

tenderapi_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""TenderAPI MCP server package."""
+
+__version__ = "0.1.0"

tenderapi_mcp/server.py

@@ -0,0 +1,161 @@
+"""TenderAPI MCP server — exposes BOAMP + TED procurement data as MCP tools.
+
+Thin wrapper over the public REST API at https://tenderapi.fr.
+
+Config (env vars):
+  TENDERAPI_KEY       — required, obtain at https://tenderapi.fr/
+  TENDERAPI_BASE_URL  — optional, default https://tenderapi.fr
+"""
+
+from __future__ import annotations
+
+import os
+from typing import Any
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+BASE_URL = os.getenv("TENDERAPI_BASE_URL", "https://tenderapi.fr").rstrip("/")
+API_KEY = os.getenv("TENDERAPI_KEY", "")
+TIMEOUT = float(os.getenv("TENDERAPI_TIMEOUT", "30"))
+
+mcp = FastMCP("tenderapi")
+
+
+def _headers() -> dict[str, str]:
+    if not API_KEY:
+        raise RuntimeError(
+            "TENDERAPI_KEY env var is not set. Get a free key at https://tenderapi.fr/"
+        )
+    return {"X-API-Key": API_KEY, "User-Agent": "tenderapi-mcp/0.1"}
+
+
+def _drop_none(params: dict[str, Any]) -> dict[str, Any]:
+    return {k: v for k, v in params.items() if v is not None}
+
+
+async def _get(path: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
+    async with httpx.AsyncClient(timeout=TIMEOUT) as client:
+        r = await client.get(f"{BASE_URL}{path}", params=params or {}, headers=_headers())
+    if r.status_code >= 400:
+        raise RuntimeError(f"TenderAPI {r.status_code}: {r.text[:400]}")
+    return r.json()
+
+
+@mcp.tool()
+async def search_tenders(
+    cpv: str | None = None,
+    region: str | None = None,
+    budget_min: float | None = None,
+    budget_max: float | None = None,
+    deadline_after: str | None = None,
+    source: str | None = None,
+    status: str | None = None,
+    buyer_siret: str | None = None,
+    country: str | None = None,
+    page: int = 1,
+    page_size: int = 20,
+) -> dict[str, Any]:
+    """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).
+    """
+    params = _drop_none({
+        "cpv": cpv, "region": region,
+        "budget_min": budget_min, "budget_max": budget_max,
+        "deadline_after": deadline_after, "source": source, "status": status,
+        "buyer_siret": buyer_siret, "country": country,
+        "page": page, "page_size": page_size,
+    })
+    return await _get("/tenders", params)
+
+
+@mcp.tool()
+async def search_awards(
+    cpv: str | None = None,
+    region: str | None = None,
+    winner_name: str | None = None,
+    winner_siret: str | None = None,
+    awarded_after: str | None = None,
+    amount_min: float | None = None,
+    source: str | None = None,
+    page: int = 1,
+    page_size: int = 20,
+) -> dict[str, Any]:
+    """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.
+    """
+    params = _drop_none({
+        "cpv": cpv, "region": region,
+        "winner_name": winner_name, "winner_siret": winner_siret,
+        "awarded_after": awarded_after, "amount_min": amount_min,
+        "source": source, "page": page, "page_size": page_size,
+    })
+    return await _get("/awards", params)
+
+
+@mcp.tool()
+async def winner_intel(
+    cpv: str | None = None,
+    region: str | None = None,
+    year: int | None = None,
+    limit: int = 10,
+) -> dict[str, Any]:
+    """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).
+    """
+    params = _drop_none({"cpv": cpv, "region": region, "year": year, "limit": limit})
+    return await _get("/awards/winner-intel", params)
+
+
+@mcp.tool()
+async def me() -> dict[str, Any]:
+    """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.
+    """
+    return await _get("/me")
+
+
+def main() -> None:
+    """CLI entry point — starts the MCP server over stdio."""
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

tenderapi_mcp-0.1.0.dist-info/METADATA

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: tenderapi-mcp
+Version: 0.1.0
+Summary: MCP server for TenderAPI — French (BOAMP) and EU (TED) public procurement data
+Project-URL: Homepage, https://tenderapi.fr
+Project-URL: Documentation, https://tenderapi.fr/docs
+Project-URL: Repository, https://github.com/IDNSIDNS/tenderapi-mcp
+Project-URL: Issues, https://github.com/IDNSIDNS/tenderapi-mcp/issues
+Author-email: TenderAPI <contact@tenderapi.fr>
+License: MIT
+License-File: LICENSE
+Keywords: api,boamp,eu,france,mcp,procurement,ted
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.0.0
+Description-Content-Type: text/markdown
+
+# 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>.
+
+## Install
+
+Requires Python 3.10+.
+
+From PyPI (once published):
+
+```bash
+pip install tenderapi-mcp
+```
+
+From source:
+
+```bash
+git clone https://github.com/IDNSIDNS/tenderapi-mcp
+cd tenderapi-mcp
+pip install -e .
+```
+
+## Configure
+
+Get a free API key at <https://tenderapi.fr/>.
+
+Set the env var:
+
+```bash
+export TENDERAPI_KEY=ta_your_key_here
+```
+
+## Use with Claude Desktop
+
+Edit your Claude Desktop config:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "tenderapi": {
+      "command": "tenderapi-mcp",
+      "env": {
+        "TENDERAPI_KEY": "ta_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The `tenderapi` server should appear in the tool picker.
+
+## Use with other MCP clients
+
+Any MCP client supporting stdio transport. The binary `tenderapi-mcp` (installed by pip) is the entry point.
+
+## Tools exposed
+
+| Tool | Tier | Description |
+|------|------|-------------|
+| `search_tenders` | Free | Search BOAMP + TED tenders with typed filters (CPV, region, budget, deadline, source…) |
+| `search_awards` | Starter | Search award notices (who won which contract, for how much) |
+| `winner_intel` | Pro | Aggregated winner stats — top companies by CPV / region / year |
+| `me` | — | Current key tier, quota remaining, available features |
+
+## Tiers
+
+- **Free**: 100 req/day — tenders only
+- **Starter** (5 €/mo HT): 5 000 req/day — adds awards + webhooks
+- **Pro** (15 €/mo HT): 50 000 req/day — adds winner intelligence
+
+See <https://tenderapi.fr/#pricing>.
+
+## Local development
+
+Override the API base URL via `TENDERAPI_BASE_URL` (default `https://tenderapi.fr`).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

tenderapi_mcp-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+tenderapi_mcp/__init__.py,sha256=N7M8780myosa4_-5RGBhRlg-wlJe8TrN9gy9CtJ4CHk,59
+tenderapi_mcp/server.py,sha256=6fyDtUl75uly72FTbQjTQqQCkqVYZ2WmsC2kGtURLN8,5346
+tenderapi_mcp-0.1.0.dist-info/METADATA,sha256=MSJxfSTN42E19wUwul3VRo4TBKu4ZFVOTdXQw6ZicRA,2686
+tenderapi_mcp-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+tenderapi_mcp-0.1.0.dist-info/entry_points.txt,sha256=XTfInXTekOHmmNT8_TPrzlmJjg5wI33Ug69HHVFZDqA,60
+tenderapi_mcp-0.1.0.dist-info/licenses/LICENSE,sha256=Mv8B-cHZieORQhNCpfdJj7aXSdvOk8Sm6f-xs3ZBDcY,1066
+tenderapi_mcp-0.1.0.dist-info/RECORD,,

tenderapi_mcp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

tenderapi_mcp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tenderapi-mcp = tenderapi_mcp.server:main

tenderapi_mcp-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TenderAPI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.