agentum-entity-resolver
Company registry, VAT, sanctions, vendor KYB, IBAN and wallet checks; pay per call by x402 or card.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (8)
- HIGH
- MEDIUMen resolve_entity
- MEDIUMen verify_eu_vat
- MEDIUMen screen_sanctions
- MEDIUMen check_vendor
- MEDIUMen verify_bank_payee
- MEDIUMen screen_address
- MEDIUMen batch_resolve
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"agentum-entity-resolver": {
"url": "https://agentum.asimplek.cloud/mcp"
}
}
}Puntos de conexión remotos
https://agentum.asimplek.cloud/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (7)
🟢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
Esquema de entrada
{
"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
}Esquema de salida
{
"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
Esquema de entrada
{
"type": "object",
"properties": {
"vatNumber": {
"type": "string",
"minLength": 4,
"description": "EU VAT number including 2-letter country prefix (e.g. 'LT100004278519')"
}
},
"required": [
"vatNumber"
],
"additionalProperties": false
}Esquema de salida
{
"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
Esquema de entrada
{
"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
}Esquema de salida
{
"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
Esquema de entrada
{
"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
}Esquema de salida
{
"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
Esquema de entrada
{
"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
}Esquema de salida
{
"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
Esquema de entrada
{
"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
}Esquema de salida
{
"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
Esquema de entrada
{
"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
}Esquema de salida
{
"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
}Comunidad
Evidencia