Skip to main content
Glama
README.md
# DataX France & 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 **France & EU** registries with non-custodial pay-per-call settlement in **USDC** (Base, Polygon, Solana) and **MiCA EURC** (Base).

- **Live Endpoint:** `https://datax-fr.duckdns.org`
- **Machine Discovery:** [`/llms.txt`](https://datax-fr.duckdns.org/llms.txt) · [`/mcp.json`](https://datax-fr.duckdns.org/mcp.json) · [`/.well-known/agent-card.json`](https://datax-fr.duckdns.org/.well-known/agent-card.json) · [`/openapi.json`](https://datax-fr.duckdns.org/openapi.json) · [`/.well-known/ai-crawl-pricing.json`](https://datax-fr.duckdns.org/.well-known/ai-crawl-pricing.json)
- **Agent Payment Protocol & Wallet Guide:** See [`SKILL.md`](./SKILL.md)

---

## Official Data Sources Indexed

- **French Commercial Registry (`BODACC`):** Daily company formations (`CONSTITUCION` with capital), corporate modifications, deregistrations, and collective insolvency proceedings (`CONCURSO_DISOLUCION`). Legal entities (`pm` / 9-digit SIREN) only; natural persons (`pp`) skipped per GDPR.
- **French Public Procurement (`BOAMP`):** National, regional, and municipal calls (`PC`) and award notices (`PA`).
- **EU Registries:** **EU TED v3** procurement (`FRA`, `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 France & EU registries; returns opaque `item_ref` (`dx_...`). |
| `find_distressed_auctions` | **`0.10`** | Real-estate auction endpoint (populated on Spain node; empty on France-only DB). |
| `find_funded_companies` | **`0.10`** | Companies incorporated with capital in BODACC or winning EU/French awards. |
| `check_company_risk` | **`0.30`** | Screen 9-digit SIREN or company_name across BODACC insolvencies, EU FSF sanctions & 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-france-eu": {
      "command": "python3",
      "args": ["/absolute/path/to/mcp_bridge.py"],
      "env": {
        "DATAX_BASE_URL": "https://datax-fr.duckdns.org",
        "DATAX_TOKEN": "<unspent-utxo-token-from-issue-token>"
      }
    }
  }
}
```

TDQS

A4.3/5.0

Scored across 7 tools

Disambiguation4/5

Most tools have clearly distinct purposes: search_tenders (full-text query), find_funded_companies (EUR-threshold funding events), check_company_risk (screening a known company), and get_tender_detail (unlock by item_ref). The descriptions explicitly disambiguate overlapping search tools and point between them. The only rough spot is find_distressed_auctions, which looks related to tender search but is actually a dead-end compatibility bridge returning empty results on this server.

Naming Consistency5/5

All seven tools follow a consistent snake_case verb_noun pattern (check_company_risk, find_funded_companies, search_tenders, get_tender_detail, get_catalog, get_pricing, find_distressed_auctions). No mixing of conventions or vague one-word verbs.

Tool Count4/5

Seven tools is a well-scoped set for a paid data-query API: two free metadata tools, three search/screening tools, one detail unlock, and one bridge. The only inefficiency is find_distressed_auctions, which cannot function against this France node and is effectively dead weight in the set.

Completeness4/5

The surface covers the full lifecycle: discovery (get_catalog, get_pricing), search/filtering, risk screening, and drill-down via get_tender_detail with an item_ref. The payment flow (catalog/pricing before paid calls, 402 handling) is also accounted for. Minor gaps remain around pagination or explicit date-range filtering, but core workflows are covered.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues