Skip to main content
Glama

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).


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).


Related MCP server: Spain Open Data MCP

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)

{
  "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>"
      }
    }
  }
}

Available Tools

7 tools
check_company_riskCorporate KYB & Compliance Risk CheckA
Read-onlyIdempotent

Perform corporate KYB compliance screening across BORME insolvencies, CNMV warnings, EU FSF sanctions, BDNS grants, and public contract awards. Costs $0.30 USDC or EURC per call via DATAX_TOKEN (returns HTTP 402 if unset). Requires cif and/or company_name (corporate tax/VAT IDs only; personal national IDs are blocked for GDPR). Returns risk_alert boolean, risk_level ('HIGH', 'LOW', or 'UNKNOWN'), hit counts by category, and item_ref handles ('dx_...') unlockable via get_tender_detail ($0.50).

Inputs: cif, company_name. Returns: result, status, change_token

find_distressed_auctionsFind Discounted Real-Estate AuctionsA
Read-onlyIdempotent

Screen official Spanish judicial and notarial real-estate auctions enriched with Catastro valuation data, ranked ascending by debt-to-value ratio (ltv_pct) and equity margin. Costs $0.10 USDC or EURC per call via DATAX_TOKEN (returns HTTP 402 if unset). Returns masked auction previews and opaque item_ref handles ('dx_...') unlockable via get_tender_detail ($0.50). Use this specifically to discover discounted Spanish property auctions; use search_tenders for non-auction records.

Inputs: limit, ambito, max_ltv_pct, min_value_eur, +1 more. Returns: result, status, change_token

find_funded_companiesScreen Companies Receiving Grants, Awards, or CapitalA
Read-onlyIdempotent

Identify companies in Spain receiving newly awarded government grants, public procurement contracts, or share-capital raises above an EUR threshold. Costs $0.10 USDC or EURC per call via DATAX_TOKEN (returns HTTP 402 if unset). Returns masked previews with EUR amounts and opaque item_ref handles ('dx_...') to unlock beneficiary identities via get_tender_detail ($0.50). Prefer this over search_tenders when filtering by EUR liquidity thresholds or event_type; use check_company_risk to vet a known company.

Inputs: limit, query, ambito, event_type, +1 more. Returns: result, status, change_token

get_catalogGet Live Dataset Catalog & FreshnessA
Read-onlyIdempotent

Retrieve live dataset freshness (data_version), total indexed records, earliest and latest publication dates (YYYYMMDD), and exact record counts grouped by registry section and notice type on datax-es.duckdns.org. Free read-only call requiring no DATAX_TOKEN. Call this to verify available sections and date coverage before querying with search_tenders or find_funded_companies.

Inputs: no named parameters. Returns: datasets, total_returned

get_pricingGet Payment Pricing & TreasuriesA
Read-onlyIdempotent

Retrieve supported blockchains (Base, Polygon, Solana), accepted stablecoins (USDC and MiCA EURC), treasury recipient addresses, token contracts, and per-call USD/EUR prices ($0.10 search/screening, $0.30 corporate risk check, $0.50 full record unlock) for datax-es.duckdns.org. Free read-only call requiring no DATAX_TOKEN. Call this before minting payment tokens via /api/v1/challenge or calling paid tools.

Inputs: no named parameters. Returns: feed_id, service, currency, kyb_price, +7 more

get_tender_detailUnlock Full Official Record by ReferenceA
Read-onlyIdempotent

Unlock the complete, unredacted official record—including full company and contracting authority names, corporate tax IDs, official document ID (boe_id), verbatim text, and official PDF/HTML/XML URLs—for $0.50 USDC or EURC per call via DATAX_TOKEN (returns HTTP 402 if unset). Requires an opaque item_ref ('dx_...') returned by search_tenders, find_funded_companies, find_distressed_auctions, or check_company_risk. Always run one of those screening tools first to obtain an item_ref.

Inputs: item_ref (required). Returns: result, status, change_token

search_tendersSearch Official Registry & Tender RecordsA
Read-onlyIdempotent

Run full-text and structured searches across indexed Spain and EU official registries (BOE, BORME, BDNS, PLACSP, Catastro Auctions, CNMV, EU TED, SEDIA, EU FSF, and Consolidated Laws). Costs $0.10 USDC or EURC per call using DATAX_TOKEN (returns HTTP 402 payment instructions if unset or depleted; auto-rotates change_token in memory). Returns masked previews and opaque item_ref handles ('dx_...'); pass an item_ref to get_tender_detail ($0.50) to unlock full verbatim text, corporate IDs, and official URLs. Use find_funded_companies when filtering by EUR amounts/liquidity events, find_distressed_auctions for real-estate discounts, or check_company_risk to screen a specific company.

Inputs: limit, query, date_to, seccion, +3 more. Returns: result, status, change_token, change_micros

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for querying Spanish government open data APIs including grants, legislation, company registry, statistics, and open data catalog. Enables LLMs to access Spanish public information on-the-fly.
      26
      5
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables answering business questions about Spanish places by resolving place names and returning population, household and income statistics down to municipality, district and census tract level from official INE data, cross-checked between sources with province, region and country benchmarks. Every figure is delivered with its publisher, dataset id, data year and retrieval date, alongside caveat checks for suppressed, stale, thin-sample or estimated values.
      13
      59 PyPI
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude, Cursor, and other MCP clients to search Spanish BOE/BORME gazettes, open and forthcoming EU funding calls, and TED public procurement notices through read-only tools that return live JSON with source links.
      3
      1
      MIT