datax-italy-eu-mcp
# DataX Italy & EU Truth Engine — MCP Server (`stdio`)
Zero-dependency **Model Context Protocol (MCP)** `stdio` bridge (`Python 3.9+` standard library only — no `pip install` required) connecting AI agents (Claude Desktop, Cursor, OpenClaw, custom MCP clients) to live official **Italy & EU** registries with non-custodial pay-per-call settlement in **USDC** (Base, Polygon, Solana) and **MiCA EURC** (Base).
- **Live Endpoint:** `https://datax-it.duckdns.org`
- **Machine Discovery:** [`/llms.txt`](https://datax-it.duckdns.org/llms.txt) · [`/mcp.json`](https://datax-it.duckdns.org/mcp.json) · [`/.well-known/agent-card.json`](https://datax-it.duckdns.org/.well-known/agent-card.json) · [`/openapi.json`](https://datax-it.duckdns.org/openapi.json) · [`/.well-known/ai-crawl-pricing.json`](https://datax-it.duckdns.org/.well-known/ai-crawl-pricing.json)
- **Agent Payment Protocol & Wallet Guide:** See [`SKILL.md`](./SKILL.md)
---
## Official Data Sources Indexed
- **Italian Public Procurement (`ANAC BDNCP PVL`):** Real-time tenders (`BANDI` -> `PC`) and contract awards (`RISULTATI` / `AFFIDAMENTI` -> `PA`) with CIG, CPV, award values, and corporate winners (11-digit Partita IVA). Natural-person 16-char Codice Fiscale, emails, and phones stripped per GDPR.
- **Official Gazette (`Gazzetta Ufficiale`):** Serie Generale legislation (`Sec LC`) and 5ª Serie Contratti Pubblici (`Sec PC`).
- **EU Registries:** **EU TED v3** procurement (`ITA`, `Sec TE`), **EU SEDIA** grants (`Sec EU`), and **EU Consolidated Financial Sanctions List (`FSF`, `Sec SF`)**.
---
## MCP Tools Exposed (7 Tools)
| Tool | Price (`USDC` / `EURC`) | Purpose |
| :--- | :---: | :--- |
| `get_pricing` | **Free** | Fetch supported networks, contracts, treasuries, and tier prices. |
| `get_catalog` | **Free** | Check live freshness (`data_version`) and record counts by section. |
| `search_tenders` | **`0.10`** | FTS5 BM25 + BI filter search across Italy & EU registries; returns opaque `item_ref` (`dx_...`). |
| `find_distressed_auctions` | **`0.10`** | Real-estate auction endpoint (populated on Spain node; empty on Italy-only DB). |
| `find_funded_companies` | **`0.10`** | Companies winning Italian public contracts (ANAC PVL) or EU grants. |
| `check_company_risk` | **`0.30`** | Screen 11-digit Partita IVA or company_name across EU FSF sanctions & ANAC/TED awards. |
| `get_tender_detail` | **`0.50`** | Unlocks full verbatim record, winner corporate IDs, CPVs & official URLs from any `item_ref`. |
---
## Quick Setup (Claude Desktop / Cursor)
```json
{
"mcpServers": {
"datax-italy-eu": {
"command": "python3",
"args": ["/absolute/path/to/mcp_bridge.py"],
"env": {
"DATAX_BASE_URL": "https://datax-it.duckdns.org",
"DATAX_TOKEN": "<unspent-utxo-token-from-issue-token>"
}
}
}
}
```
TDQS
Scored across 7 tools
search_tenders and find_funded_companies overlap on the same record pool, though the descriptions explicitly steer selection by EUR-threshold vs full-text intent, which mitigates the risk. The real hazard is find_distressed_auctions: on this Italy server it is documented to always return empty unless DATAX_BASE_URL is repointed, so it reads like a valid auction tool but is a guaranteed dead end that an agent may still select.
All seven tools follow a clean snake_case verb_noun pattern (search_tenders, find_funded_companies, check_company_risk, get_catalog, get_pricing, get_tender_detail). Verb variety (search/find/check/get) maps meaningfully to action type rather than being arbitrary, so the set remains predictable.
Seven tools is well-scoped for a paid procurement-data API: three discovery/screening entry points, one detail unlock, and two free metadata tools. Each tool has a distinct job, and nothing feels padded except arguably the misplaced Spain bridge.
The surface covers the full paid workflow: catalog/freshness to orient, pricing to prep payment, search and EUR-threshold screening to discover, risk screening for KYB, and item_ref unlock for full records. Minor gaps remain: no company-centric listing of all awards for a known CIF, no bulk/export operation, and the Spain auction tool is dead weight on this node rather than a working capability.