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

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

---

## Official Data Sources Indexed

- **Portuguese Public Procurement (`IMPIC / Portal BASE` via `dados.gov.pt`):** Daily official contracts (`PA`) and announcements (`PC`) with contractual price, CPV, NUTS region, and corporate winners (9-digit corporate NIPC `[5679]\d{8}` only; natural persons and sole traders excluded per GDPR).
- **EU Registries:** **EU TED v3** procurement (`PRT`, `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 Portugal & EU registries; returns opaque `item_ref` (`dx_...`). |
| `find_distressed_auctions` | **`0.10`** | Real-estate auction endpoint (populated on Spain node; empty on Portugal-only DB). |
| `find_funded_companies` | **`0.10`** | Companies winning Portuguese public contracts (IMPIC BASE) or EU grants. |
| `check_company_risk` | **`0.30`** | Screen 9-digit corporate NIPC or company_name across EU FSF sanctions & BASE/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-portugal-eu": {
      "command": "python3",
      "args": ["/absolute/path/to/mcp_bridge.py"],
      "env": {
        "DATAX_BASE_URL": "https://datax-pt.duckdns.org",
        "DATAX_TOKEN": "<unspent-utxo-token-from-issue-token>"
      }
    }
  }
}
```

TDQS

A4.4/5.0

Scored across 7 tools

Disambiguation4/5

The three retrieval tools are reasonably separated by intent: search_tenders for full-text queries, find_funded_companies for EUR-threshold filtering, and check_company_risk for vetting a known company, with descriptions explicitly cross-referencing each other. The main blemish is find_distressed_auctions, a Spanish-node bridge that always returns empty on this server, which is an odd near-no-op that an agent could mistakenly call.

Naming Consistency5/5

All seven tools follow a clean verb_noun snake_case pattern (search_tenders, get_tender_detail, check_company_risk, find_funded_companies, get_catalog, get_pricing, find_distressed_auctions). The mix of search/find/get/check verbs is purposeful and readable rather than chaotic.

Tool Count4/5

Seven tools is a tight, well-scoped surface with no redundant entries. The only questionable slot is find_distressed_auctions, which does not function against the Portugal node and arguably does not earn a place in this server's set.

Completeness4/5

The core lifecycle is covered: discover via search_tenders/find_funded_companies, screen via check_company_risk, unlock full records via get_tender_detail, and verify coverage/cost via get_catalog and get_pricing (both free). Minor gaps remain—there is no tool to mint payment tokens via /api/v1/challenge or to check DATAX_TOKEN balance, both of which the descriptions reference as external steps.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues