VERIDEX
Verify Spanish companies by CIF: registry data, status and BORME filings, paid per call over x402.
我該用這個嗎
品質與安全性
B
根據工具定義與協定合規性的自動化分析。
上下文成本
~3,218Token（工具定義）
~11.5 KB典型回應大小
顯著的注意力影響（128k 上下文的 2.51%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"veridex-mcp": {
"url": "https://mcp.veridexia.es/mcp"
}
}
}遠端端點
https://mcp.veridexia.es/mcpstreamable-http它能做什麼
工具清單
工具（3）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢verify_company_by_cif(cif, x_payment, idempotency_key)
Verify a Spanish company by its CIF and get its registry data, status in the BORME, recent published acts and an explainable 0-100 risk score. This is an x402-paid endpoint. The first call returns ok=false with error.code='payment_required' and a complete `payment` challenge (price, network, asset, receiving address). Settle that challenge with a wallet you control and call again with the resulting base64 payload in `x_payment`; the same call then returns the company. Errors are typed: 'not_found' (valid CIF, no record — you are not charged), 'source_unavailable' (upstream registry down — not charged, safe to retry), 'invalid_request' (malformed CIF), 'rate_limited' (quota), 'transport_error' (the API was unreachable). Do not retry a 402 without changing the payment.
輸入結構描述
{
"type": "object",
"properties": {
"cif": {
"title": "Cif",
"type": "string"
},
"x_payment": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "X Payment"
},
"idempotency_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Idempotency Key"
}
},
"required": [
"cif"
],
"title": "verify_company_by_cifArguments"
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"title": "Ok",
"type": "boolean"
},
"cif": {
"default": "",
"description": "The CIF as requested.",
"title": "Cif",
"type": "string"
},
"company": {
"anyOf": [
{
"$ref": "#/$defs/CompanyInfo"
},
{
"type": "null"
}
],
"default": null
},
"risk": {
"anyOf": [
{
"$ref": "#/$defs/RiskAssessment"
},
{
"type": "null"
}
],
"default": null
},
"recent_acts": {
"items": {
"$ref": "#/$defs/BormeAct"
},
"title": "Recent Acts",
"type": "array"
},
"mock": {
"default": false,
"description": "True when the facts are synthetic, never true for a real source.",
"title": "Mock",
"type": "boolean"
},
"provenance": {
"anyOf": [
{
"$ref": "#/$defs/Provenance"
},
{
"type": "null"
}
],
"default": null
},
"payment": {
"anyOf": [
{
"$ref": "#/$defs/PaymentChallenge"
},
{
"type": "null"
}
],
"default": null
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/ErrorInfo"
},
{
"type": "null"
}
],
"default": null
},
"guidance": {
"default": "",
"description": "What to do next, in one sentence, for the calling agent.",
"title": "Guidance",
"type": "string"
}
},
"required": [
"ok"
],
"$defs": {
"BormeAct": {
"description": "A recent BORME publication attached to the company.",
"properties": {
"date": {
"default": "",
"title": "Date",
"type": "string"
},
"section": {
"default": "",
"title": "Section",
"type": "string"
},
"description": {
"default": "",
"title": "Description",
"type": "string"
}
},
"title": "BormeAct",
"type": "object"
},
"CompanyInfo": {
"description": "What the merchant knows about the company, verbatim from the source.",
"properties": {
"cif": {
"title": "Cif",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"legal_form": {
"default": "",
"title": "Legal Form",
"type": "string"
},
"status": {
"default": "unknown",
"title": "Status",
"type": "string"
},
"status_label": {
"default": "",
"title": "Status Label",
"type": "string"
},
"province": {
"default": "",
"title": "Province",
"type": "string"
},
"incorporation_date": {
"default": "",
"title": "Incorporation Date",
"type": "string"
},
"last_borme_deposit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Last accounts deposit in the BORME; null when the source has no record.",
"title": "Last Borme Deposit"
},
"administrator": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Administrator"
},
"share_capital_cents": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Share Capital Cents"
},
"insolvency_published_on": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Insolvency Published On"
}
},
"required": [
"cif",
"name"
],
"title": "CompanyInfo",
"type": "object"
},
"ErrorInfo": {
"description": "A typed failure. ``code`` is the field to branch on.",
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"message": {
"default": "",
"title": "Message",
"type": "string"
},
"http_status": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "null when the request never reached the API (DNS, TLS, timeout).",
"title": "Http Status"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
},
"details": {
"additionalProperties": true,
"title": "Details",
"type": "object"
}
},
"required": [
"code"
],
"title": "ErrorInfo",
"type": "object"
},
"PaymentChallenge": {
"description": "The ``402`` body and header, decoded into something an agent can act on.",
"properties": {
"x402_version": {
"default": 1,
"title": "X402 Version",
"type": "integer"
},
"scheme": {
"default": "exact",
"title": "Scheme",
"type": "string"
},
"network": {
"default": "",
"title": "Network",
"type": "string"
},
"asset": {
"default": "",
"title": "Asset",
"type": "string"
},
"pay_to": {
"default": "",
"title": "Pay To",
"type": "string"
},
"amount_atomic": {
"default": 0,
"title": "Amount Atomic",
"type": "integer"
},
"price_eur_cents": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Eur Cents"
},
"resource": {
"default": "",
"title": "Resource",
"type": "string"
},
"description": {
"default": "",
"title": "Description",
"type": "string"
},
"max_timeout_seconds": {
"default": 300,
"title": "Max Timeout Seconds",
"type": "integer"
},
"accepts": {
"items": {
"$ref": "#/$defs/PaymentOption"
},
"title": "Accepts",
"type": "array"
},
"payment_header": {
"default": "X-PAYMENT",
"title": "Payment Header",
"type": "string"
},
"payment_required_header_value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64 X-PAYMENT-REQUIRED header, verbatim.",
"title": "Payment Required Header Value"
},
"instructions": {
"default": "",
"description": "The next step, spelled out. Written for a model to follow.",
"title": "Instructions",
"type": "string"
}
},
"title": "PaymentChallenge",
"type": "object"
},
"PaymentOption": {
"description": "One accepted way to pay, mirroring x402's ``accepts[]`` entry.\n\nField names are the wire's own (``payTo``, ``maxAmountRequired``) because these\nvalues are pasted straight into a payment payload. Tidying them here would be\nthe friendliest possible way to send money to the wrong place.",
"properties": {
"scheme": {
"default": "exact",
"title": "Scheme",
"type": "string"
},
"network": {
"default": "",
"title": "Network",
"type": "string"
},
"asset": {
"default": "",
"title": "Asset",
"type": "string"
},
"payTo": {
"default": "",
"title": "Payto",
"type": "string"
},
"maxAmountRequired": {
"default": "",
"title": "Maxamountrequired",
"type": "string"
},
"resource": {
"default": "",
"title": "Resource",
"type": "string"
},
"description": {
"default": "",
"title": "Description",
"type": "string"
},
"mimeType": {
"default": "application/json",
"title": "Mimetype",
"type": "string"
},
"maxTimeoutSeconds": {
"default": 300,
"title": "Maxtimeoutseconds",
"type": "integer"
},
"extra": {
"additionalProperties": true,
"title": "Extra",
"type": "object"
}
},
"title": "PaymentOption",
"type": "object"
},
"Provenance": {
"description": "Where the facts came from, so a paying caller can judge the answer.",
"properties": {
"source": {
"default": "unknown",
"description": "'prometiam', 'opendata', 'mock', ...",
"title": "Source",
"type": "string"
},
"fetched_at": {
"default": "",
"title": "Fetched At",
"type": "string"
},
"from_cache": {
"default": false,
"title": "From Cache",
"type": "boolean"
},
"confidence": {
"default": "medium",
"title": "Confidence",
"type": "string"
},
"endpoint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Endpoint"
}
},
"title": "Provenance",
"type": "object"
},
"RiskAssessment": {
"description": "An explainable score, so a decision made with it can be audited later.",
"properties": {
"value": {
"description": "0 = safest, 100 = riskiest.",
"maximum": 100,
"minimum": 0,
"title": "Value",
"type": "integer"
},
"band": {
"default": "low",
"title": "Band",
"type": "string"
},
"reasons": {
"items": {
"type": "string"
},
"title": "Reasons",
"type": "array"
},
"signals": {
"items": {
"$ref": "#/$defs/RiskSignal"
},
"title": "Signals",
"type": "array"
},
"confidence": {
"default": "medium",
"title": "Confidence",
"type": "string"
},
"assurance": {
"default": "low",
"title": "Assurance",
"type": "string"
},
"conclusive": {
"default": false,
"description": "True when the underlying data is sufficient to decide on.",
"title": "Conclusive",
"type": "boolean"
}
},
"required": [
"value"
],
"title": "RiskAssessment",
"type": "object"
},
"RiskSignal": {
"description": "One scoring factor. Branch on ``code``; the wording may change.",
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"points": {
"title": "Points",
"type": "integer"
},
"description": {
"default": "",
"title": "Description",
"type": "string"
}
},
"required": [
"code",
"points"
],
"title": "RiskSignal",
"type": "object"
}
},
"description": "Result of ``verify_company_by_cif``.\n\n``ok`` is the single field to check first. When it is true, ``company`` and\n``risk`` are populated. When it is false, ``error`` says why and ``guidance``\nsays what to do about it — including, for a ``402``, ``payment`` in full.",
"title": "VerifyResult"
}🟢get_veridex_info
Describe the VERIDEX service: what it does, its price, the settlement network and asset, the receiving address and the available endpoints. Reads the public discovery manifest at /.well-known/x402. Needs no credentials and costs nothing. Call this before verifying if you need to know what a verification costs or where the payment goes.
輸入結構描述
{
"type": "object",
"properties": {},
"title": "get_veridex_infoArguments"
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"title": "Ok",
"type": "boolean"
},
"name": {
"default": "",
"title": "Name",
"type": "string"
},
"description": {
"default": "",
"title": "Description",
"type": "string"
},
"manifest_version": {
"default": "",
"title": "Manifest Version",
"type": "string"
},
"network": {
"default": "",
"title": "Network",
"type": "string"
},
"asset": {
"default": "",
"title": "Asset",
"type": "string"
},
"asset_symbol": {
"default": "",
"title": "Asset Symbol",
"type": "string"
},
"asset_decimals": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Asset Decimals"
},
"pay_to": {
"default": "",
"title": "Pay To",
"type": "string"
},
"endpoints": {
"items": {
"$ref": "#/$defs/EndpointInfo"
},
"title": "Endpoints",
"type": "array"
},
"price": {
"default": "",
"title": "Price",
"type": "string"
},
"how_to_pay": {
"default": "",
"title": "How To Pay",
"type": "string"
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/ErrorInfo"
},
{
"type": "null"
}
],
"default": null
},
"raw_manifest": {
"additionalProperties": true,
"title": "Raw Manifest",
"type": "object"
}
},
"required": [
"ok"
],
"$defs": {
"EndpointInfo": {
"description": "A paid endpoint as the discovery manifest publishes it.",
"properties": {
"path": {
"default": "",
"title": "Path",
"type": "string"
},
"method": {
"default": "POST",
"title": "Method",
"type": "string"
},
"price_eur_cents": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Eur Cents"
},
"price_usdc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usdc"
},
"amount_atomic": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Amount Atomic"
},
"description": {
"default": "",
"title": "Description",
"type": "string"
},
"payment_required": {
"default": false,
"title": "Payment Required",
"type": "boolean"
}
},
"title": "EndpointInfo",
"type": "object"
},
"ErrorInfo": {
"description": "A typed failure. ``code`` is the field to branch on.",
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"message": {
"default": "",
"title": "Message",
"type": "string"
},
"http_status": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "null when the request never reached the API (DNS, TLS, timeout).",
"title": "Http Status"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
},
"details": {
"additionalProperties": true,
"title": "Details",
"type": "object"
}
},
"required": [
"code"
],
"title": "ErrorInfo",
"type": "object"
}
},
"description": "Result of ``get_veridex_info``: what this service is and what it costs.",
"title": "ServiceInfo"
}🟢health_check
Check whether the VERIDEX API is up, and see today's demand: uptime, the number of verification calls served today and the distinct callers. Free and unauthenticated. The request count excludes the service's own healthchecks and local tests, so it answers 'is anyone using this?' rather than 'is the process alive?'. Useful before starting a paid flow.
輸入結構描述
{
"type": "object",
"properties": {},
"title": "health_checkArguments"
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"title": "Ok",
"type": "boolean"
},
"status": {
"default": "unknown",
"description": "'ok' when the API is serving.",
"title": "Status",
"type": "string"
},
"api_url": {
"default": "",
"title": "Api Url",
"type": "string"
},
"reachable": {
"default": false,
"title": "Reachable",
"type": "boolean"
},
"uptime_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Uptime Seconds"
},
"requests_today": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Requests Today"
},
"unique_agents_today": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Unique Agents Today"
},
"latency_ms": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Latency Ms"
},
"checked_at": {
"default": "",
"title": "Checked At",
"type": "string"
},
"error": {
"anyOf": [
{
"$ref": "#/$defs/ErrorInfo"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"ok"
],
"$defs": {
"ErrorInfo": {
"description": "A typed failure. ``code`` is the field to branch on.",
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"message": {
"default": "",
"title": "Message",
"type": "string"
},
"http_status": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "null when the request never reached the API (DNS, TLS, timeout).",
"title": "Http Status"
},
"retryable": {
"default": false,
"title": "Retryable",
"type": "boolean"
},
"details": {
"additionalProperties": true,
"title": "Details",
"type": "object"
}
},
"required": [
"code"
],
"title": "ErrorInfo",
"type": "object"
}
},
"description": "Result of ``health_check``.",
"title": "HealthResult"
}社群
證據
近期觀測
已驗證未記錄版本3 個工具