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

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

---

## Official Data Sources Indexed

- **Spain Official Gazette (`BOE`):** Laws, public employment (`2B`), energy/expropriations, sanctions, and public procurement (`5A`, `5B`, `5C`).
- **Spain Commercial Registry (`BORME`):** Daily incorporations, capital increases, appointments, M&A mergers, and insolvencies across all 50 provinces + Ceuta & Melilla.
- **Spain National Grants (`BDNS / SNPSAP`):** Open subsidy calls (`SA`) and corporate grant awards (`SC` with corporate CIF).
- **Spain & Regional Public Procurement (`PLACSP`):** National, municipal, and regional tenders/awards (`PC`, `PA`, including offer counts).
- **Real-Estate Judicial/Notarial Auctions (`subastas.boe.es` + `Catastro`):** Enriched with appraisal/auction value, claimed debt, surface (`m²`), usage, and build year.
- **Consolidated Spanish Core Laws (`Sec LC`):** Article-by-article latest active text of 12 foundational codes (Constitution, LPACAP 39/2015, LRJSP 40/2015, LCSP 9/2017, Civil/Penal/LEC, LSC, LGT, Labor, LOPDGDD).
- **Financial Markets & Sanctions:** Spain **CNMV** official RSS (`Sec MV`), **EU TED v3** procurement (`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 all Spain & EU registries; returns opaque `item_ref` (`dx_...`). |
| `find_distressed_auctions` | **`0.10`** | Ranks official real-estate auctions by debt-to-value (`ltv_pct`) and equity margin. |
| `find_funded_companies` | **`0.10`** | Screens companies with newly awarded grants, public contracts, or capital raises. |
| `check_company_risk` | **`0.30`** | Corporate KYB cross-check by `cif` / `company_name` across BORME insolvencies, EU FSF sanctions, CNMV & awards. |
| `get_tender_detail` | **`0.50`** | Unlocks full verbatim record, CIF/razón social, address, Cadastral Ref & official URLs from any `item_ref`. |

---

## Quick Setup (Claude Desktop / Cursor)

```json
{
  "mcpServers": {
    "datax-spain-eu": {
      "command": "python3",
      "args": ["/absolute/path/to/mcp_bridge.py"],
      "env": {
        "DATAX_BASE_URL": "https://datax-es.duckdns.org",
        "DATAX_TOKEN": "<unspent-utxo-token-from-issue-token>"
      }
    }
  }
}

TDQS

A4.6/5.0

Scored across 7 tools

Disambiguation5/5

Each tool has a distinct resource+action target: two free metadata lookups (get_catalog, get_pricing), one general search (search_tenders), three specialized screeners (auctions, funded companies, company risk), and one detail unlocker (get_tender_detail). The descriptions explicitly cross-reference each other with 'Use X when... / prefer this over search_tenders when...' guidance, and get_tender_detail is clearly gated behind an item_ref from the screening tools. Overlap between search_tenders and the find_*/check_* tools is acknowledged and resolved in text.

Naming Consistency5/5

All seven names follow a consistent snake_case verb_noun pattern (get_catalog, get_pricing, search_tenders, find_distressed_auctions, find_funded_companies, check_company_risk, get_tender_detail). The verb variety (get/find/search/check) is semantically meaningful rather than arbitrary, and no camelCase or style mixing appears.

Tool Count5/5

Seven tools is well within the ideal 3-15 range and each one earns its place: discovery, pricing, general search, three orthogonal screeners, and a detail unlock. There is no redundancy or filler in the surface.

Completeness4/5

The surface covers the full workflow: orient (catalog/pricing) -> screen (search/find/check) -> unlock full record via item_ref, with clear lifecycle from masked preview to verbatim detail. Minor gaps exist around token/wallet management (no balance-check or mint tool; payment setup is deferred to an external /api/v1/challenge endpoint), which could leave an agent at a dead end when DATAX_TOKEN is unset or depleted, though 402 responses carry instructions.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues