agentum-entity-resolver

Company registry, VAT, sanctions, vendor KYB, IBAN and wallet checks; pay per call by x402 or card.

Should I use this

Quality & Safety

B
Description quality
100%
Schema completeness
100%
Naming quality
89%
Poisoning risk
0%
Permission match
100%
Protocol compliance
100%

Findings (8)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool description contains URL to non-standard domainin resolve_entity
  • MEDIUMTool description contains URL to non-standard domainin verify_eu_vat
  • MEDIUMTool description contains URL to non-standard domainin screen_sanctions
  • MEDIUMTool description contains URL to non-standard domainin check_vendor
  • MEDIUMTool description contains URL to non-standard domainin verify_bank_payee
  • MEDIUMTool description contains URL to non-standard domainin screen_address
  • MEDIUMTool description contains URL to non-standard domainin batch_resolve

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~9,062Tokens (tool definitions)
~13.3 KBTypical response size
Significant attention impact (7.08% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "agentum-entity-resolver": {
      "url": "https://agentum.asimplek.cloud/mcp"
    }
  }
}

Remote endpoints

https://agentum.asimplek.cloud/mcpstreamable-http

What it can do

Tool inventory

Tools (7)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢resolve_entity(query, jurisdiction, country, verifyVat, includeParent, ...)

Resolves a company to its official registry record: legal name, registration number, status, legal form, LEI, VAT. Use when onboarding a vendor, verifying a counterparty on an invoice, or enriching a company name or domain with registry IDs. Inputs: query (name, domain or registration number); optional jurisdiction (ISO-2), verifyVat, checkSanctions. Returns: resolved, confidence, entity, candidates, compliance, vatVerification. Sources: official registries (GLEIF, SEC EDGAR, Companies House, EU registers). Same input → same output. $0.005 per call after 5 free calls/day; pay by card credits, x402: https://agentum.asimplek.cloud/pay

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Company name, domain, or registration number (LEI, CIK, EIN, UK Company No, Swiss UID, ABN/ACN, UEN, JAR, VAT)"
    },
    "jurisdiction": {
      "description": "Optional 2-letter ISO country code (e.g. GB, CH, AU, SG, US, LT, DE) or auto-detected",
      "type": "string"
    },
    "country": {
      "description": "Alias for jurisdiction",
      "type": "string"
    },
    "verifyVat": {
      "description": "Verify EU VAT number against live VIES if available",
      "type": "boolean"
    },
    "includeParent": {
      "description": "Include parent and ultimate parent LEI relationships",
      "type": "boolean"
    },
    "checkSanctions": {
      "description": "Cross-screen entity against OFAC SDN, EU FSF, UN SC and UK FCDO sanctions lists (default true)",
      "type": "boolean"
    },
    "includeOfficers": {
      "description": "Include corporate directors, executives, and officers when available",
      "type": "boolean"
    },
    "includeBeneficialOwners": {
      "description": "Include current beneficial owners (e.g. UK Persons with Significant Control) when available",
      "type": "boolean"
    },
    "includeCompanyEvents": {
      "description": "Include recent official company notices where available (France BODACC); dated evidence, not a current-status or ownership verdict",
      "type": "boolean"
    },
    "allowPaidSources": {
      "description": "Allow fallback to commercial paid aggregators when official registries are paywalled or unavailable",
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "resolved": {
      "type": "boolean"
    },
    "confidence": {
      "type": "number"
    },
    "queryType": {
      "type": "string",
      "enum": [
        "LEI",
        "EU_VAT",
        "LT_JAR",
        "US_CIK",
        "US_EIN",
        "UK_CRN",
        "CH_UID",
        "AU_ABN",
        "AU_ACN",
        "SG_UEN",
        "NATIONAL_ID",
        "DOMAIN",
        "NAME"
      ]
    },
    "modeUsed": {
      "type": "string",
      "enum": [
        "local",
        "hybrid",
        "live",
        "cache"
      ]
    },
    "entity": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "canonicalName": {
              "type": "string"
            },
            "normalizedName": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "region": {
              "type": "string",
              "enum": [
                "EU",
                "US",
                "OTHER"
              ]
            },
            "primaryIdType": {
              "type": "string",
              "enum": [
                "LEI",
                "LT_JAR",
                "US_CIK",
                "US_EIN",
                "EU_VAT",
                "NATIONAL_REG"
              ]
            },
            "primaryIdValue": {
              "type": "string"
            },
            "lei": {
              "type": [
                "string",
                "null"
              ]
            },
            "registrationNumber": {
              "type": [
                "string",
                "null"
              ]
            },
            "registrationAuthority": {
              "type": [
                "string",
                "null"
              ]
            },
            "vatNumber": {
              "type": [
                "string",
                "null"
              ]
            },
            "vatValid": {
              "type": [
                "boolean",
                "null"
              ]
            },
            "taxId": {
              "type": [
                "string",
                "null"
              ]
            },
            "cik": {
              "type": [
                "string",
                "null"
              ]
            },
            "tickers": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "legalForm": {
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "type": "string",
              "enum": [
                "ACTIVE",
                "INACTIVE",
                "DISSOLVED",
                "LIQUIDATING",
                "UNKNOWN"
              ]
            },
            "incorporationDate": {
              "type": [
                "string",
                "null"
              ]
            },
            "legalAddress": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "street": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "postalCode": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "country": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "country"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "headquartersAddress": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "street": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "postalCode": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "country": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "country"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "parentLei": {
              "type": [
                "string",
                "null"
              ]
            },
            "ultimateParentLei": {
              "type": [
                "string",
                "null"
              ]
            },
            "domains": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "aliases": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "sources": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "source": {
                    "type": "string"
                  },
                  "sourceId": {
                    "type": "string"
                  },
                  "fetchedAt": {
                    "type": "string"
                  }
                },
                "required": [
                  "source",
                  "sourceId",
                  "fetchedAt"
                ],
                "additionalProperties": false
              }
            },
            "confidence": {
              "type": "number",
              "minimum": 0,
              "maximum": 1
            },
            "officers": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "role": {
                    "type": "string"
                  },
                  "appointedOn": {
                    "type": "string"
                  },
                  "resignedOn": {
                    "type": "string"
                  },
                  "nationality": {
                    "type": "string"
                  },
                  "occupation": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "role"
                ],
                "additionalProperties": false
              }
            },
            "beneficialOwners": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "INDIVIDUAL",
                      "CORPORATE",
                      "LEGAL_PERSON",
                      "PROTECTED",
                      "UNKNOWN"
                    ]
                  },
                  "naturesOfControl": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "notifiedOn": {
                    "type": "string"
                  },
                  "ceasedOn": {
                    "type": "string"
                  },
                  "nationality": {
                    "type": "string"
                  },
                  "countryOfResidence": {
                    "type": "string"
                  },
                  "birthYearMonth": {
                    "type": "string"
                  },
                  "registrationNumber": {
                    "type": "string"
                  },
                  "countryRegistered": {
                    "type": "string"
                  },
                  "legalForm": {
                    "type": "string"
                  },
                  "source": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "kind",
                  "naturesOfControl",
                  "source"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "canonicalName",
            "normalizedName",
            "jurisdiction",
            "region",
            "primaryIdType",
            "primaryIdValue",
            "lei",
            "registrationNumber",
            "registrationAuthority",
            "vatNumber",
            "vatValid",
            "taxId",
            "cik",
            "tickers",
            "legalForm",
            "status",
            "incorporationDate",
            "legalAddress",
            "headquartersAddress",
            "parentLei",
            "ultimateParentLei",
            "domains",
            "aliases",
            "sources",
            "confidence"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "compliance": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "sanctioned": {
              "type": "boolean"
            },
            "riskLevel": {
              "type": "string",
              "enum": [
                "CLEAR",
                "POTENTIAL_MATCH",
                "EXACT_MATCH",
                "UNKNOWN"
              ]
            },
            "matchScore": {
              "type": "number"
            },
            "matchedLists": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "matches": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "listSource": {
                    "type": "string",
                    "enum": [
                      "OFAC_SDN",
                      "EU_FSF",
                      "UN_SC",
                      "UK_FCDO"
                    ]
                  },
                  "externalId": {
                    "type": "string"
                  },
                  "primaryName": {
                    "type": "string"
                  },
                  "entityType": {
                    "type": "string"
                  },
                  "programs": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "score": {
                    "type": "number"
                  },
                  "remarks": {
                    "type": "string"
                  }
                },
                "required": [
                  "listSource",
                  "externalId",
                  "primaryName",
                  "entityType",
                  "programs",
                  "score"
                ],
                "additionalProperties": false
              }
            },
            "degraded": {
              "default": false,
              "type": "boolean"
            },
            "degradedReason": {
              "type": "string"
            },
            "coverage": {
              "type": "object",
              "properties": {
                "recordCount": {
                  "type": "number"
                },
                "sourcesScreened": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "lastSyncAt": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "recordCount",
                "sourcesScreened"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "sanctioned",
            "riskLevel",
            "matchScore",
            "matchedLists",
            "matches",
            "degraded"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "vatVerification": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "valid": {
              "type": "boolean"
            },
            "countryCode": {
              "type": "string"
            },
            "vatNumber": {
              "type": "string"
            },
            "fullVat": {
              "type": "string"
            },
            "registeredName": {
              "type": [
                "string",
                "null"
              ]
            },
            "registeredAddress": {
              "type": [
                "string",
                "null"
              ]
            },
            "checkedAt": {
              "type": "string"
            },
            "source": {
              "type": "string",
              "enum": [
                "EU_VIES",
                "CACHE",
                "SYNTAX_ONLY"
              ]
            },
            "error": {
              "type": "string"
            }
          },
          "required": [
            "valid",
            "countryCode",
            "vatNumber",
            "fullVat",
            "registeredName",
            "registeredAddress",
            "checkedAt",
            "source"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "canonicalName": {
            "type": "string"
          },
          "normalizedName": {
            "type": "string"
          },
          "jurisdiction": {
            "type": "string"
          },
          "region": {
            "type": "string",
            "enum": [
              "EU",
              "US",
              "OTHER"
            ]
          },
          "primaryIdType": {
            "type": "string",
            "enum": [
              "LEI",
              "LT_JAR",
              "US_CIK",
              "US_EIN",
              "EU_VAT",
              "NATIONAL_REG"
            ]
          },
          "primaryIdValue": {
            "type": "string"
          },
          "lei": {
            "type": [
              "string",
              "null"
            ]
          },
          "registrationNumber": {
            "type": [
              "string",
              "null"
            ]
          },
          "registrationAuthority": {
            "type": [
              "string",
              "null"
            ]
          },
          "vatNumber": {
            "type": [
              "string",
              "null"
            ]
          },
          "vatValid": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "taxId": {
            "type": [
              "string",
              "null"
            ]
          },
          "cik": {
            "type": [
              "string",
              "null"
            ]
          },
          "tickers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "legalForm": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "ACTIVE",
              "INACTIVE",
              "DISSOLVED",
              "LIQUIDATING",
              "UNKNOWN"
            ]
          },
          "incorporationDate": {
            "type": [
              "string",
              "null"
            ]
          },
          "legalAddress": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "street": {
                    "type": "string"
                  },
                  "city": {
                    "type": "string"
                  },
                  "postalCode": {
                    "type": "string"
                  },
                  "region": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  }
                },
                "required": [
                  "country"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "headquartersAddress": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "street": {
                    "type": "string"
                  },
                  "city": {
                    "type": "string"
                  },
                  "postalCode": {
                    "type": "string"
                  },
                  "region": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  }
                },
                "required": [
                  "country"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "parentLei": {
            "type": [
              "string",
              "null"
            ]
          },
          "ultimateParentLei": {
            "type": [
              "string",
              "null"
            ]
          },
          "domains": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "aliases": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "source": {
                  "type": "string"
                },
                "sourceId": {
                  "type": "string"
                },
                "fetchedAt": {
                  "type": "string"
                }
              },
              "required": [
                "source",
                "sourceId",
                "fetchedAt"
              ],
              "additionalProperties": false
            }
          },
          "confidence": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "officers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "role": {
                  "type": "string"
                },
                "appointedOn": {
                  "type": "string"
                },
                "resignedOn": {
                  "type": "string"
                },
                "nationality": {
                  "type": "string"
                },
                "occupation": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "role"
              ],
              "additionalProperties": false
            }
          },
          "beneficialOwners": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "kind": {
                  "type": "string",
                  "enum": [
                    "INDIVIDUAL",
                    "CORPORATE",
                    "LEGAL_PERSON",
                    "PROTECTED",
                    "UNKNOWN"
                  ]
                },
                "naturesOfControl": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "notifiedOn": {
                  "type": "string"
                },
                "ceasedOn": {
                  "type": "string"
                },
                "nationality": {
                  "type": "string"
                },
                "countryOfResidence": {
                  "type": "string"
                },
                "birthYearMonth": {
                  "type": "string"
                },
                "registrationNumber": {
                  "type": "string"
                },
                "countryRegistered": {
                  "type": "string"
                },
                "legalForm": {
                  "type": "string"
                },
                "source": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "kind",
                "naturesOfControl",
                "source"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "canonicalName",
          "normalizedName",
          "jurisdiction",
          "region",
          "primaryIdType",
          "primaryIdValue",
          "lei",
          "registrationNumber",
          "registrationAuthority",
          "vatNumber",
          "vatValid",
          "taxId",
          "cik",
          "tickers",
          "legalForm",
          "status",
          "incorporationDate",
          "legalAddress",
          "headquartersAddress",
          "parentLei",
          "ultimateParentLei",
          "domains",
          "aliases",
          "sources",
          "confidence"
        ],
        "additionalProperties": false
      }
    },
    "coverage": {
      "type": "object",
      "properties": {
        "country": {
          "type": "string"
        },
        "level": {
          "type": "string"
        },
        "sourcesTried": {
          "type": "array",
          "items": {}
        },
        "paidSourceUsed": {
          "type": "boolean"
        },
        "sourcesSkipped": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "source": {
                "type": "string"
              },
              "reason": {
                "type": "string",
                "enum": [
                  "NOT_CONFIGURED",
                  "DISABLED",
                  "CIRCUIT_OPEN"
                ]
              },
              "detail": {
                "type": "string"
              }
            },
            "required": [
              "source",
              "reason"
            ],
            "additionalProperties": false
          }
        },
        "coverageNote": {
          "type": "string"
        }
      },
      "required": [
        "country",
        "level",
        "sourcesTried",
        "paidSourceUsed"
      ],
      "additionalProperties": false
    },
    "beneficialOwnership": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "OK",
            "UNAVAILABLE",
            "UNSUPPORTED"
          ]
        },
        "source": {
          "type": [
            "string",
            "null"
          ]
        },
        "ownerCount": {
          "type": "number"
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "status",
        "source",
        "ownerCount"
      ],
      "additionalProperties": false
    },
    "companyEvents": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "OK",
            "UNAVAILABLE",
            "UNSUPPORTED"
          ]
        },
        "source": {
          "type": [
            "string",
            "null"
          ]
        },
        "events": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1
              },
              "source": {
                "type": "string",
                "const": "FR_BODACC"
              },
              "sourceUrl": {
                "type": "string",
                "format": "uri"
              },
              "publishedAt": {
                "type": "string",
                "format": "date",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
              },
              "category": {
                "type": "string",
                "minLength": 1
              },
              "description": {
                "type": "string",
                "minLength": 1
              },
              "companyRegistrationNumber": {
                "type": "string",
                "pattern": "^\\d{9}$"
              }
            },
            "required": [
              "id",
              "source",
              "sourceUrl",
              "publishedAt",
              "category",
              "description",
              "companyRegistrationNumber"
            ],
            "additionalProperties": false
          }
        },
        "truncated": {
          "type": "boolean"
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "status",
        "source",
        "events",
        "truncated"
      ],
      "additionalProperties": false
    },
    "latencyMs": {
      "type": "number"
    }
  },
  "required": [
    "resolved",
    "confidence",
    "queryType",
    "modeUsed",
    "entity",
    "compliance",
    "vatVerification",
    "candidates",
    "latencyMs"
  ],
  "additionalProperties": false
}
🟢verify_eu_vat(vatNumber)

Validates an EU VAT number against the European Commission VIES service and returns the registered name and address. Use when validating the VAT ID on a supplier invoice, applying reverse charge on a cross-border B2B sale, or confirming a vendor's VAT registration at onboarding. Inputs: vatNumber with 2-letter country prefix (e.g. DE129274202). Returns: valid, countryCode, vatNumber, registeredName, registeredAddress, checkedAt, source (EU_VIES, CACHE, SYNTAX_ONLY), linkedEntity. Source: EU VIES live. Same input → same output. $0.005 per call after 5 free calls/day; pay by card credits, x402: https://agentum.asimplek.cloud/pay

Input Schema

{
  "type": "object",
  "properties": {
    "vatNumber": {
      "type": "string",
      "minLength": 4,
      "description": "EU VAT number including 2-letter country prefix (e.g. 'LT100004278519')"
    }
  },
  "required": [
    "vatNumber"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean"
    },
    "countryCode": {
      "type": "string"
    },
    "vatNumber": {
      "type": "string"
    },
    "fullVat": {
      "type": "string"
    },
    "registeredName": {
      "type": [
        "string",
        "null"
      ]
    },
    "registeredAddress": {
      "type": [
        "string",
        "null"
      ]
    },
    "checkedAt": {
      "type": "string"
    },
    "source": {
      "type": "string",
      "enum": [
        "EU_VIES",
        "CACHE",
        "SYNTAX_ONLY"
      ]
    },
    "error": {
      "type": "string"
    },
    "linkedEntity": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "canonicalName": {
              "type": "string"
            },
            "normalizedName": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "region": {
              "type": "string",
              "enum": [
                "EU",
                "US",
                "OTHER"
              ]
            },
            "primaryIdType": {
              "type": "string",
              "enum": [
                "LEI",
                "LT_JAR",
                "US_CIK",
                "US_EIN",
                "EU_VAT",
                "NATIONAL_REG"
              ]
            },
            "primaryIdValue": {
              "type": "string"
            },
            "lei": {
              "type": [
                "string",
                "null"
              ]
            },
            "registrationNumber": {
              "type": [
                "string",
                "null"
              ]
            },
            "registrationAuthority": {
              "type": [
                "string",
                "null"
              ]
            },
            "vatNumber": {
              "type": [
                "string",
                "null"
              ]
            },
            "vatValid": {
              "type": [
                "boolean",
                "null"
              ]
            },
            "taxId": {
              "type": [
                "string",
                "null"
              ]
            },
            "cik": {
              "type": [
                "string",
                "null"
              ]
            },
            "tickers": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "legalForm": {
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "type": "string",
              "enum": [
                "ACTIVE",
                "INACTIVE",
                "DISSOLVED",
                "LIQUIDATING",
                "UNKNOWN"
              ]
            },
            "incorporationDate": {
              "type": [
                "string",
                "null"
              ]
            },
            "legalAddress": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "street": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "postalCode": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "country": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "country"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "headquartersAddress": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "street": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "postalCode": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "country": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "country"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "parentLei": {
              "type": [
                "string",
                "null"
              ]
            },
            "ultimateParentLei": {
              "type": [
                "string",
                "null"
              ]
            },
            "domains": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "aliases": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "sources": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "source": {
                    "type": "string"
                  },
                  "sourceId": {
                    "type": "string"
                  },
                  "fetchedAt": {
                    "type": "string"
                  }
                },
                "required": [
                  "source",
                  "sourceId",
                  "fetchedAt"
                ],
                "additionalProperties": false
              }
            },
            "confidence": {
              "type": "number",
              "minimum": 0,
              "maximum": 1
            },
            "officers": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "role": {
                    "type": "string"
                  },
                  "appointedOn": {
                    "type": "string"
                  },
                  "resignedOn": {
                    "type": "string"
                  },
                  "nationality": {
                    "type": "string"
                  },
                  "occupation": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "role"
                ],
                "additionalProperties": false
              }
            },
            "beneficialOwners": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "INDIVIDUAL",
                      "CORPORATE",
                      "LEGAL_PERSON",
                      "PROTECTED",
                      "UNKNOWN"
                    ]
                  },
                  "naturesOfControl": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "notifiedOn": {
                    "type": "string"
                  },
                  "ceasedOn": {
                    "type": "string"
                  },
                  "nationality": {
                    "type": "string"
                  },
                  "countryOfResidence": {
                    "type": "string"
                  },
                  "birthYearMonth": {
                    "type": "string"
                  },
                  "registrationNumber": {
                    "type": "string"
                  },
                  "countryRegistered": {
                    "type": "string"
                  },
                  "legalForm": {
                    "type": "string"
                  },
                  "source": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "kind",
                  "naturesOfControl",
                  "source"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "canonicalName",
            "normalizedName",
            "jurisdiction",
            "region",
            "primaryIdType",
            "primaryIdValue",
            "lei",
            "registrationNumber",
            "registrationAuthority",
            "vatNumber",
            "vatValid",
            "taxId",
            "cik",
            "tickers",
            "legalForm",
            "status",
            "incorporationDate",
            "legalAddress",
            "headquartersAddress",
            "parentLei",
            "ultimateParentLei",
            "domains",
            "aliases",
            "sources",
            "confidence"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "valid",
    "countryCode",
    "vatNumber",
    "fullVat",
    "registeredName",
    "registeredAddress",
    "checkedAt",
    "source",
    "linkedEntity"
  ],
  "additionalProperties": false
}
🟢screen_sanctions(name, country, registrationNumber, threshold)

Screens a company or person against OFAC SDN, EU, UN and UK FCDO sanctions lists with exact and fuzzy matching. Use when screening a counterparty before paying, checking a new vendor or customer for sanctions exposure, or re-screening a payee after a detail change. Inputs: name; optional country (ISO-2), registrationNumber, threshold (default 0.75). Returns: sanctioned, riskLevel (CLEAR/POTENTIAL_MATCH/EXACT_MATCH/UNKNOWN), matchScore, matchedLists, matches[]. Sources: OFAC/EU/UN/UK lists refreshed every 6h. Same input → same output. $0.005 per call after 5 free calls/day; pay by card credits, x402: https://agentum.asimplek.cloud/pay

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Entity or individual name to screen"
    },
    "country": {
      "description": "Optional 2-letter ISO country code",
      "type": "string"
    },
    "registrationNumber": {
      "description": "Optional company registration, LEI, or tax ID",
      "type": "string"
    },
    "threshold": {
      "description": "Trigram similarity threshold (default 0.75)",
      "type": "number",
      "minimum": 0.1,
      "maximum": 1
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "sanctioned": {
      "type": "boolean"
    },
    "riskLevel": {
      "type": "string",
      "enum": [
        "CLEAR",
        "POTENTIAL_MATCH",
        "EXACT_MATCH",
        "UNKNOWN"
      ]
    },
    "matchScore": {
      "type": "number"
    },
    "matchedLists": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "listSource": {
            "type": "string",
            "enum": [
              "OFAC_SDN",
              "EU_FSF",
              "UN_SC",
              "UK_FCDO"
            ]
          },
          "externalId": {
            "type": "string"
          },
          "primaryName": {
            "type": "string"
          },
          "entityType": {
            "type": "string"
          },
          "programs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "score": {
            "type": "number"
          },
          "remarks": {
            "type": "string"
          }
        },
        "required": [
          "listSource",
          "externalId",
          "primaryName",
          "entityType",
          "programs",
          "score"
        ],
        "additionalProperties": false
      }
    },
    "degraded": {
      "default": false,
      "type": "boolean"
    },
    "degradedReason": {
      "type": "string"
    },
    "coverage": {
      "type": "object",
      "properties": {
        "recordCount": {
          "type": "number"
        },
        "sourcesScreened": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "lastSyncAt": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "recordCount",
        "sourcesScreened"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "sanctioned",
    "riskLevel",
    "matchScore",
    "matchedLists",
    "matches",
    "degraded"
  ],
  "additionalProperties": false
}
🟢check_vendor(name, country, vatNumber, registrationNumber, domain)

One-call vendor KYB: registry lookup, EU VAT check and OFAC/EU/UN/UK sanctions screening with a verdict. Use when onboarding a supplier, approving a vendor before first payment, or re-checking a counterparty. Inputs: name; optional country (ISO-2), vatNumber, registrationNumber, domain. Returns: verdict (APPROVED/FLAGGED_FOR_REVIEW/REJECTED), riskLevel, sanctionsHit, vatValid, entity, auditTrail[]. Sources: official registries (GLEIF, Companies House); EU VIES live; OFAC/EU/UN/UK lists refreshed every 6h. Same input → same output. $0.010 per call after 5 free calls/day; pay by card credits, x402: https://agentum.asimplek.cloud/pay

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Legal or trade name of the vendor/counterparty"
    },
    "country": {
      "description": "2-letter ISO country code (e.g. 'DE', 'GB', 'US', 'CH', 'AU', 'SG')",
      "type": "string"
    },
    "vatNumber": {
      "description": "EU VAT number with 2-letter country prefix (e.g. 'DE129274202')",
      "type": "string"
    },
    "registrationNumber": {
      "description": "National registration number (CRN, UID, ABN, UEN, CIK, or LEI)",
      "type": "string"
    },
    "domain": {
      "description": "Vendor primary web domain (e.g. 'siemens.com')",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "vendorName": {
      "type": "string"
    },
    "verdict": {
      "type": "string",
      "enum": [
        "APPROVED",
        "FLAGGED_FOR_REVIEW",
        "REJECTED"
      ]
    },
    "riskLevel": {
      "type": "string",
      "enum": [
        "CLEAR",
        "LOW_RISK",
        "MEDIUM_RISK",
        "HIGH_RISK",
        "CRITICAL"
      ]
    },
    "confidence": {
      "type": "number"
    },
    "sanctionsHit": {
      "type": "boolean"
    },
    "vatValid": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "entity": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "canonicalName": {
              "type": "string"
            },
            "normalizedName": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "region": {
              "type": "string",
              "enum": [
                "EU",
                "US",
                "OTHER"
              ]
            },
            "primaryIdType": {
              "type": "string",
              "enum": [
                "LEI",
                "LT_JAR",
                "US_CIK",
                "US_EIN",
                "EU_VAT",
                "NATIONAL_REG"
              ]
            },
            "primaryIdValue": {
              "type": "string"
            },
            "lei": {
              "type": [
                "string",
                "null"
              ]
            },
            "registrationNumber": {
              "type": [
                "string",
                "null"
              ]
            },
            "registrationAuthority": {
              "type": [
                "string",
                "null"
              ]
            },
            "vatNumber": {
              "type": [
                "string",
                "null"
              ]
            },
            "vatValid": {
              "type": [
                "boolean",
                "null"
              ]
            },
            "taxId": {
              "type": [
                "string",
                "null"
              ]
            },
            "cik": {
              "type": [
                "string",
                "null"
              ]
            },
            "tickers": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "legalForm": {
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "type": "string",
              "enum": [
                "ACTIVE",
                "INACTIVE",
                "DISSOLVED",
                "LIQUIDATING",
                "UNKNOWN"
              ]
            },
            "incorporationDate": {
              "type": [
                "string",
                "null"
              ]
            },
            "legalAddress": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "street": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "postalCode": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "country": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "country"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "headquartersAddress": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "street": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "postalCode": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "country": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "country"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "parentLei": {
              "type": [
                "string",
                "null"
              ]
            },
            "ultimateParentLei": {
              "type": [
                "string",
                "null"
              ]
            },
            "domains": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "aliases": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "sources": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "source": {
                    "type": "string"
                  },
                  "sourceId": {
                    "type": "string"
                  },
                  "fetchedAt": {
                    "type": "string"
                  }
                },
                "required": [
                  "source",
                  "sourceId",
                  "fetchedAt"
                ],
                "additionalProperties": false
              }
            },
            "confidence": {
              "type": "number",
              "minimum": 0,
              "maximum": 1
            },
            "officers": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "role": {
                    "type": "string"
                  },
                  "appointedOn": {
                    "type": "string"
                  },
                  "resignedOn": {
                    "type": "string"
                  },
                  "nationality": {
                    "type": "string"
                  },
                  "occupation": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "role"
                ],
                "additionalProperties": false
              }
            },
            "beneficialOwners": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "INDIVIDUAL",
                      "CORPORATE",
                      "LEGAL_PERSON",
                      "PROTECTED",
                      "UNKNOWN"
                    ]
                  },
                  "naturesOfControl": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "notifiedOn": {
                    "type": "string"
                  },
                  "ceasedOn": {
                    "type": "string"
                  },
                  "nationality": {
                    "type": "string"
                  },
                  "countryOfResidence": {
                    "type": "string"
                  },
                  "birthYearMonth": {
                    "type": "string"
                  },
                  "registrationNumber": {
                    "type": "string"
                  },
                  "countryRegistered": {
                    "type": "string"
                  },
                  "legalForm": {
                    "type": "string"
                  },
                  "source": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "kind",
                  "naturesOfControl",
                  "source"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "canonicalName",
            "normalizedName",
            "jurisdiction",
            "region",
            "primaryIdType",
            "primaryIdValue",
            "lei",
            "registrationNumber",
            "registrationAuthority",
            "vatNumber",
            "vatValid",
            "taxId",
            "cik",
            "tickers",
            "legalForm",
            "status",
            "incorporationDate",
            "legalAddress",
            "headquartersAddress",
            "parentLei",
            "ultimateParentLei",
            "domains",
            "aliases",
            "sources",
            "confidence"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "vatVerification": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "valid": {
              "type": "boolean"
            },
            "countryCode": {
              "type": "string"
            },
            "vatNumber": {
              "type": "string"
            },
            "fullVat": {
              "type": "string"
            },
            "registeredName": {
              "type": [
                "string",
                "null"
              ]
            },
            "registeredAddress": {
              "type": [
                "string",
                "null"
              ]
            },
            "checkedAt": {
              "type": "string"
            },
            "source": {
              "type": "string",
              "enum": [
                "EU_VIES",
                "CACHE",
                "SYNTAX_ONLY"
              ]
            },
            "error": {
              "type": "string"
            }
          },
          "required": [
            "valid",
            "countryCode",
            "vatNumber",
            "fullVat",
            "registeredName",
            "registeredAddress",
            "checkedAt",
            "source"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "sanctionsScreening": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "sanctioned": {
              "type": "boolean"
            },
            "riskLevel": {
              "type": "string",
              "enum": [
                "CLEAR",
                "POTENTIAL_MATCH",
                "EXACT_MATCH",
                "UNKNOWN"
              ]
            },
            "matchScore": {
              "type": "number"
            },
            "matchedLists": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "matches": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "listSource": {
                    "type": "string",
                    "enum": [
                      "OFAC_SDN",
                      "EU_FSF",
                      "UN_SC",
                      "UK_FCDO"
                    ]
                  },
                  "externalId": {
                    "type": "string"
                  },
                  "primaryName": {
                    "type": "string"
                  },
                  "entityType": {
                    "type": "string"
                  },
                  "programs": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "score": {
                    "type": "number"
                  },
                  "remarks": {
                    "type": "string"
                  }
                },
                "required": [
                  "listSource",
                  "externalId",
                  "primaryName",
                  "entityType",
                  "programs",
                  "score"
                ],
                "additionalProperties": false
              }
            },
            "degraded": {
              "default": false,
              "type": "boolean"
            },
            "degradedReason": {
              "type": "string"
            },
            "coverage": {
              "type": "object",
              "properties": {
                "recordCount": {
                  "type": "number"
                },
                "sourcesScreened": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "lastSyncAt": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "recordCount",
                "sourcesScreened"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "sanctioned",
            "riskLevel",
            "matchScore",
            "matchedLists",
            "matches",
            "degraded"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "auditTrail": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "evaluatedAt": {
      "type": "string"
    },
    "coverageNote": {
      "type": "string"
    },
    "sourcesSkipped": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "string"
          },
          "reason": {
            "type": "string",
            "enum": [
              "NOT_CONFIGURED",
              "DISABLED",
              "CIRCUIT_OPEN"
            ]
          },
          "detail": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "reason"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "vendorName",
    "verdict",
    "riskLevel",
    "confidence",
    "sanctionsHit",
    "vatValid",
    "entity",
    "vatVerification",
    "sanctionsScreening",
    "auditTrail",
    "evaluatedAt"
  ],
  "additionalProperties": false
}
🟢verify_bank_payee(iban, expectedCountry, payeeName, payeeTaxId)

Validates an IBAN (ISO 13616 format, length, MOD-97 checksum) and checks the account country matches the expected payee country. Use when validating bank details on an invoice, confirming a payee's account change before paying, or checking for invoice redirection. Inputs: iban; optional expectedCountry (ISO-2), payeeName, payeeTaxId (for ownership lookup in public registers). Returns: valid, countryCode, checksumValid, countryMatch, ownershipVerified, issues[]. Sources: ISO 13616 rules; public registers. Same input → same output. $0.003 per call after 5 free calls/day; pay by card credits, x402: https://agentum.asimplek.cloud/pay

Input Schema

{
  "type": "object",
  "properties": {
    "iban": {
      "type": "string",
      "minLength": 10,
      "description": "International Bank Account Number (IBAN), spaces permitted"
    },
    "expectedCountry": {
      "description": "Expected 2-letter ISO country code of the payee/vendor (e.g. 'DE')",
      "type": "string"
    },
    "payeeName": {
      "description": "Optional legal payee name to cross-check against bank account jurisdiction",
      "type": "string"
    },
    "payeeTaxId": {
      "description": "National tax/business registration number (e.g. Polish NIP or Czech IČO) to verify account ownership against official public registers",
      "type": "string"
    }
  },
  "required": [
    "iban"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean"
    },
    "normalizedIban": {
      "type": "string"
    },
    "countryCode": {
      "type": "string"
    },
    "bankCode": {
      "type": [
        "string",
        "null"
      ]
    },
    "checksumValid": {
      "type": "boolean"
    },
    "countryMatch": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "expectedLength": {
      "type": [
        "number",
        "null"
      ]
    },
    "actualLength": {
      "type": "number"
    },
    "ownershipVerified": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "ownershipSource": {
      "type": [
        "string",
        "null"
      ]
    },
    "issues": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "checkedAt": {
      "type": "string"
    }
  },
  "required": [
    "valid",
    "normalizedIban",
    "countryCode",
    "bankCode",
    "checksumValid",
    "countryMatch",
    "expectedLength",
    "actualLength",
    "issues",
    "checkedAt"
  ],
  "additionalProperties": false
}
🟢screen_address(address, chain)

Checks a crypto wallet address (EVM, Bitcoin, Tron, Solana, Litecoin) against OFAC's listed digital-currency addresses. Exact match on the official list only; not behavioural or cluster risk. Use when about to pay or send funds to an address, vetting a counterparty wallet, or checking a deposit address. Inputs: address; optional chain (evm, bitcoin, tron, solana, litecoin, other). Returns: sanctioned, riskLevel (CLEAR/EXACT_MATCH/UNKNOWN), addressType, matches[], coverage. Source: OFAC SDN, refreshed every 6h. Same input → same output. $0.002 per call after 5 free calls/day; pay by card credits, x402: https://agentum.asimplek.cloud/pay

Input Schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Wallet address to screen (EVM 0x..., Bitcoin, Tron, Solana, Litecoin or other base58 form)"
    },
    "chain": {
      "description": "Optional chain hint: evm | bitcoin | tron | solana | litecoin | other. Rejected if it contradicts the address format.",
      "type": "string",
      "enum": [
        "evm",
        "bitcoin",
        "tron",
        "solana",
        "litecoin",
        "other"
      ]
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "sanctioned": {
      "type": "boolean"
    },
    "riskLevel": {
      "type": "string",
      "enum": [
        "EXACT_MATCH",
        "CLEAR",
        "UNKNOWN"
      ]
    },
    "address": {
      "type": "string"
    },
    "addressType": {
      "type": "string",
      "enum": [
        "EVM",
        "BITCOIN",
        "TRON",
        "SOLANA",
        "LITECOIN",
        "OTHER",
        "INVALID"
      ]
    },
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "listSource": {
            "type": "string",
            "const": "OFAC_SDN"
          },
          "externalId": {
            "type": "string"
          },
          "entityName": {
            "type": "string"
          },
          "entityType": {
            "type": "string"
          },
          "chain": {
            "type": "string"
          },
          "programs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "remarks": {
            "type": "string"
          }
        },
        "required": [
          "listSource",
          "externalId",
          "entityName",
          "entityType",
          "chain",
          "programs"
        ],
        "additionalProperties": false
      }
    },
    "coverage": {
      "type": "object",
      "properties": {
        "list": {
          "type": "string",
          "const": "OFAC_SDN"
        },
        "addressesIndexed": {
          "type": "number"
        },
        "lastSyncAt": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "list",
        "addressesIndexed",
        "lastSyncAt"
      ],
      "additionalProperties": false
    },
    "degraded": {
      "type": "boolean"
    },
    "degradedReason": {
      "type": "string"
    },
    "limitations": {
      "type": "string"
    }
  },
  "required": [
    "sanctioned",
    "riskLevel",
    "address",
    "addressType",
    "matches",
    "coverage",
    "degraded",
    "limitations"
  ],
  "additionalProperties": false
}
🟢batch_resolve(items)

Resolves 1 to 25 companies to official registry records in one call; each item works like resolve_entity. Use when onboarding a supplier list, enriching a CSV of counterparties with registration numbers and status, or deduplicating a vendor file. Inputs: items[] of {query (name, domain or registration number), optional country (ISO-2)}. Returns: total, resolvedCount, unresolvedCount, results[] (query, resolved, entity, confidence). Sources: official registries (GLEIF, SEC EDGAR, Companies House, EU registers). Same input → same output. $0.025 per call after 5 free calls/day; pay by card credits, x402: https://agentum.asimplek.cloud/pay

Input Schema

{
  "type": "object",
  "properties": {
    "items": {
      "minItems": 1,
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1,
            "description": "Company name, domain, or registration number"
          },
          "country": {
            "description": "Optional 2-letter ISO country code",
            "type": "string"
          },
          "jurisdiction": {
            "description": "Alias for country",
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "additionalProperties": false
      },
      "description": "List of entities to resolve (1 to 25 items)"
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    },
    "resolvedCount": {
      "type": "number"
    },
    "unresolvedCount": {
      "type": "number"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "resolved": {
            "type": "boolean"
          },
          "entity": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "canonicalName": {
                    "type": "string"
                  },
                  "normalizedName": {
                    "type": "string"
                  },
                  "jurisdiction": {
                    "type": "string"
                  },
                  "region": {
                    "type": "string",
                    "enum": [
                      "EU",
                      "US",
                      "OTHER"
                    ]
                  },
                  "primaryIdType": {
                    "type": "string",
                    "enum": [
                      "LEI",
                      "LT_JAR",
                      "US_CIK",
                      "US_EIN",
                      "EU_VAT",
                      "NATIONAL_REG"
                    ]
                  },
                  "primaryIdValue": {
                    "type": "string"
                  },
                  "lei": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "registrationNumber": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "registrationAuthority": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "vatNumber": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "vatValid": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "taxId": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cik": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tickers": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "legalForm": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "ACTIVE",
                      "INACTIVE",
                      "DISSOLVED",
                      "LIQUIDATING",
                      "UNKNOWN"
                    ]
                  },
                  "incorporationDate": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "legalAddress": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "street": {
                            "type": "string"
                          },
                          "city": {
                            "type": "string"
                          },
                          "postalCode": {
                            "type": "string"
                          },
                          "region": {
                            "type": "string"
                          },
                          "country": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "country"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "headquartersAddress": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "street": {
                            "type": "string"
                          },
                          "city": {
                            "type": "string"
                          },
                          "postalCode": {
                            "type": "string"
                          },
                          "region": {
                            "type": "string"
                          },
                          "country": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "country"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "parentLei": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "ultimateParentLei": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "aliases": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "sources": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "source": {
                          "type": "string"
                        },
                        "sourceId": {
                          "type": "string"
                        },
                        "fetchedAt": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "source",
                        "sourceId",
                        "fetchedAt"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "confidence": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1
                  },
                  "officers": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "role": {
                          "type": "string"
                        },
                        "appointedOn": {
                          "type": "string"
                        },
                        "resignedOn": {
                          "type": "string"
                        },
                        "nationality": {
                          "type": "string"
                        },
                        "occupation": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "name",
                        "role"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "beneficialOwners": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "INDIVIDUAL",
                            "CORPORATE",
                            "LEGAL_PERSON",
                            "PROTECTED",
                            "UNKNOWN"
                          ]
                        },
                        "naturesOfControl": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "notifiedOn": {
                          "type": "string"
                        },
                        "ceasedOn": {
                          "type": "string"
                        },
                        "nationality": {
                          "type": "string"
                        },
                        "countryOfResidence": {
                          "type": "string"
                        },
                        "birthYearMonth": {
                          "type": "string"
                        },
                        "registrationNumber": {
                          "type": "string"
                        },
                        "countryRegistered": {
                          "type": "string"
                        },
                        "legalForm": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "name",
                        "kind",
                        "naturesOfControl",
                        "source"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "canonicalName",
                  "normalizedName",
                  "jurisdiction",
                  "region",
                  "primaryIdType",
                  "primaryIdValue",
                  "lei",
                  "registrationNumber",
                  "registrationAuthority",
                  "vatNumber",
                  "vatValid",
                  "taxId",
                  "cik",
                  "tickers",
                  "legalForm",
                  "status",
                  "incorporationDate",
                  "legalAddress",
                  "headquartersAddress",
                  "parentLei",
                  "ultimateParentLei",
                  "domains",
                  "aliases",
                  "sources",
                  "confidence"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "confidence": {
            "type": "number"
          },
          "error": {
            "type": "string"
          },
          "coverageNote": {
            "type": "string"
          },
          "sourcesSkipped": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "source": {
                  "type": "string"
                },
                "reason": {
                  "type": "string",
                  "enum": [
                    "NOT_CONFIGURED",
                    "DISABLED",
                    "CIRCUIT_OPEN"
                  ]
                },
                "detail": {
                  "type": "string"
                }
              },
              "required": [
                "source",
                "reason"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "query",
          "resolved",
          "entity",
          "confidence"
        ],
        "additionalProperties": false
      }
    },
    "durationMs": {
      "type": "number"
    }
  },
  "required": [
    "total",
    "resolvedCount",
    "unresolvedCount",
    "results",
    "durationMs"
  ],
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded7 tools