datax-portugal-eu-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DATAX_TOKEN | No | Optional unspent UTXO token (USDC or MiCA EURC) from /api/v1/issue-token for paid tools. | |
| DATAX_BASE_URL | No | Base URL of the DataX Truth Engine server. | https://datax-pt.duckdns.org |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
DataX Portugal & EU Official Registry MCP Server (datax-pt.duckdns.org). 1) Call get_pricing and get_catalog for free to inspect accepted stablecoins (USDC, MiCA EURC), treasury addresses, prices ($0.10/$0.30/$0.50), and fresh section counts. 2) Set DATAX_TOKEN (issued via /api/v1/challenge and /api/v1/issue-token) to call search_tenders ($0.10), find_funded_companies ($0.10), or check_company_risk ($0.30) (use datax-spain-eu-mcp for find_distressed_auctions); each match returns an opaque item_ref ('dx_...'). 3) Pass any item_ref to get_tender_detail ($0.50) to unlock full verbatim text, corporate IDs, and official URLs. Unspent change_token balance rotates automatically in memory across consecutive calls.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_pricingA | 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-pt.duckdns.org. Free read-only call requiring no DATAX_TOKEN. Call this before minting payment tokens via /api/v1/challenge or calling paid tools. |
| get_catalogA | 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-pt.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. |
| search_tendersA | Run full-text and structured searches across indexed Portugal and EU official registries (IMPIC Portal BASE public contracts/notices, EU TED PRT, SEDIA, and EU FSF). 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 or check_company_risk to screen a specific company (use datax-spain-eu-mcp for Spanish property auctions via find_distressed_auctions). |
| find_distressed_auctionsA | Compatibility bridge for Spanish Catastro/BOE judicial real-estate auctions ($0.10 USDC or EURC via DATAX_TOKEN; returns HTTP 402 if unset). Unless DATAX_BASE_URL points to the Spain node (datax-spain-eu-mcp), calls on this Portugal server always return empty matches because Spanish property auctions are not indexed locally—prefer search_tenders or find_funded_companies for Portugal records. |
| find_funded_companiesA | Identify companies in Portugal 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. |
| check_company_riskA | Perform corporate KYB compliance screening across EU FSF sanctions and Portal BASE / TED Portuguese 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). |
| get_tender_detailA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
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.
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.
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.
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.