datax-spain-eu-mcp
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.orgMachine Discovery:
/llms.txt·/mcp.json·/.well-known/agent-card.json·/openapi.json·/.well-known/ai-crawl-pricing.jsonAgent Payment Protocol & Wallet Guide: See
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 (SCwith 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 ( | Purpose |
| Free | Fetch supported networks, contracts, treasuries, and tier prices. |
| Free | Check live freshness ( |
|
| FTS5 BM25 + BI filter search across all Spain & EU registries; returns opaque |
|
| Ranks official real-estate auctions by debt-to-value ( |
|
| Screens companies with newly awarded grants, public contracts, or capital raises. |
|
| Corporate KYB cross-check by |
|
| Unlocks full verbatim record, CIF/razón social, address, Cadastral Ref & official URLs from any |
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 toolscheck_company_riskCorporate KYB & Compliance Risk CheckARead-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 AuctionsARead-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 CapitalARead-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 & FreshnessARead-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 & TreasuriesARead-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 ReferenceARead-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 RecordsARead-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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
BOE, Spanish public tenders and INE statistics behind one MCP server.
Search Spain's BOE/BORME gazettes, open EU funding calls and EU TED tenders. Keyless sources.
MCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.
Official public data as MCP tools: EU/US tenders, NPI Registry, UK Companies House, Mexico data.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP 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.265MIT
- AlicenseAqualityBmaintenanceEnables 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.1359 PyPIMIT
- AlicenseAqualityBmaintenanceEnables 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.31MIT
- AlicenseAqualityBmaintenanceZero-dependency MCP stdio bridge for Germany & EU official registries (oeffentlichevergabe.de tenders/awards, BaFin sanctions, Gesetze-im-Internet laws, TED, EU FSF) with pay-per-call USDC & MiCA EURC settlement.47MIT