Agentum Entity Resolver

io.github.AlgirasPublished by GitHub account Algirasv0.2.1Updated Nov 7, 2026

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

VerifiedStreamable HTTPWeb executableFinanceSecurity & MonitoringBusiness & Commerce

Overview

AI-generated overview

Remote MCP server that resolves companies to official registry records and runs VAT, sanctions, IBAN and wallet compliance checks.

What you can do
  • Resolve companies to official registry records by name, domain or registration number, singly or in batches of up to 25
  • Validate EU VAT numbers against VIES and screen names against OFAC, EU, UN and UK sanctions lists
  • Run a one-call vendor KYB check combining registry, VAT and sanctions with a verdict
  • Validate IBANs and payee country, and screen crypto wallet addresses against OFAC's listed addresses
When to use it
Useful when onboarding suppliers, verifying a counterparty on an invoice, applying reverse charge on cross-border B2B sales, or checking bank details and wallet addresses before sending money.
Requirements
A remote streamable HTTP endpoint; no signup or API key is needed for the free tier. Beyond 5 free calls per day, payment is required via x402 (USDC on Base) or prepaid credits bought by card, passed through payment metadata or an API key.
Before you install
Calls beyond the free daily quota cost money ($0.002 to $0.025 per call) and payment credentials or wallet funds may be requested. Queries about companies, people, VAT numbers, IBANs and wallet addresses are sent to a third-party service. Results are read-only but should not be treated as a substitute for formal compliance advice.

Installation

In SourceWeft

  1. Open Agentum Entity Resolver in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Algiras%2Fagentum-entity-resolver/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Agentum — Global Corporate Entity, VAT & Sanctions Resolver for AI Agents

Registry availability depends on the server configuration. UK Companies House is verified locally; hosted UK access is not yet confirmed. Australian ABR and New Zealand NZBN are disabled without credentials; Japan NTA is pending approval. GLEIF lookup can still return LEI holders in these countries. Check /v1/coverage for the connected server’s current registry coverage.

Zero-Signup Streamable HTTP MCP Server & REST API for deterministic corporate entity resolution across global national registries (UK Companies House, Swiss ZEFIX, Singapore ACRA, US SEC EDGAR, European Registries, and Worldwide GLEIF LEI), live EU Commission VIES VAT validation, and OFAC SDN + EU Financial Sanctions + UN Security Council screening (26,650+ live records).

[License: MIT] [MCP Server] [Dual 402] [Claude Plugin] [Gemini Extension]


Agent Discovery & Platform Connection

1. Anthropic Claude (Claude Code, Desktop & Web)

  • Claude Code CLI:
    bash
    claude mcp add --transport http agentum https://agentum.asimplek.cloud/mcp
  • Claude Plugin Marketplace: Sync directly from GitHub: Algiras/agentum-skills. The .claude-plugin/marketplace.json manifest installs the agentum-entity-resolver plugin automatically.

2. OpenAI ChatGPT

  • Custom MCP Server / Actions: Go to ChatGPT Settings → Plugins / Custom MCP Servers → Add Server:
    • Server URL: https://agentum.asimplek.cloud/mcp
    • Auth: OAuth 2.1 auto-negotiation (https://agentum.asimplek.cloud/oauth/authorize) or None.
    • Manifest Discovery: https://agentum.asimplek.cloud/.well-known/ai-plugin.json

3. Mistral AI (Le Chat)

  • Custom Connectors: Go to Mistral Le Chat → Workspace Connections → Add Connector:
    • URL: https://agentum.asimplek.cloud/mcp
    • Transport: Streamable HTTP / Server-Sent Events (SSE)
  • Skills CLI:
    bash
    npx skills add Algiras/agentum-skills

4. Google Gemini & Antigravity

  • Gemini CLI Extension:
    bash
    gemini extension install Algiras/agentum-skills
    (Uses gemini-extension.json and GEMINI.md system context)

5. Cursor IDE & Generic MCP Clients

Add to .mcp.json or claude_desktop_config.json:

json
{  "mcpServers": {    "agentum": {      "type": "http",      "url": "https://agentum.asimplek.cloud/mcp"    }  }}

6. Autonomous Agent-to-Agent (A2A) & Protocol Registries

Autonomous agents can discover and inspect capabilities programmatically via well-known schemas:

  • A2A Agent Card: https://agentum.asimplek.cloud/.well-known/agent.json
  • MCP Server Card: https://agentum.asimplek.cloud/.well-known/mcp/server-card
  • Coinbase x402 Bazaar (Base USDC): https://agentum.asimplek.cloud/.well-known/x402.json
  • Stripe / Tempo MPP Registry: https://agentum.asimplek.cloud/.well-known/mpp.json
  • OpenAPI 3.1 Spec: https://agentum.asimplek.cloud/openapi.json
  • LLM Scraper Guide: https://agentum.asimplek.cloud/llms.txt & https://agentum.asimplek.cloud/llms-full.txt

Tools & Micropayments (Dual-402)

Every caller receives 5 free calls per day automatically (tracked by X-Agent-Id or IP). Beyond the free quota, calls return an HTTP 402 Payment Required response with challenges for both rails:

  1. Coinbase x402 v2: Native settlement in USDC on Base (base-mainnet or base-sepolia).
  2. Stripe / Tempo Machine Payments Protocol (MPP): Standard Payment challenge header with instant receipt issuance.
Tool (MCP)HTTP EndpointFree TierPriceDescription
resolve_entityPOST /v1/entity/resolve5 calls/day$0.005Resolve company worldwide by LEI, VAT, CIK/EIN, UK CRN, CH UID, AU ABN/ACN, SG UEN, domain, or fuzzy legal name
verify_eu_vatPOST /v1/entity/vat-verify5 calls/day$0.002Live European Commission VIES VAT validation + entity cross-reference
screen_sanctionsPOST /v1/entity/sanctions-screen5 calls/day$0.002Screen against 26,650+ OFAC SDN, EU Financial Sanctions & UN SC targets (homoglyph & trigram resistant)
check_vendorPOST /v1/compliance/check-vendor5 calls/day$0.0101-shot KYB due diligence returning APPROVED, FLAGGED_FOR_REVIEW, or REJECTED with multi-factor audit trail
verify_bank_payeePOST /v1/compliance/verify-bank-payee5 calls/day$0.003ISO-13616 Mod-97 IBAN checksum validation and country alignment check
batch_resolvePOST /v1/entity/batch-resolve5 calls/day$0.025Concurrently resolve multiple companies across national registries in one call

Full MCP 2025-03-26 Protocol Suite

  • Streamable HTTP Transport: Full SSE streaming on GET /mcp, batch JSON-RPC support on POST /mcp, session termination on DELETE /mcp.
  • Tools with Compact Optimization: Supports _meta.compact: true returning token-saving summaries alongside deep-link resource URIs (agentum://results/{requestId}).
  • Dynamic Resources:
    • agentum://entity/{query} & agentum://entity/{query}/compact
    • agentum://vat/{vatNumber}
    • agentum://sanctions/{name}
    • agentum://results/{requestId}
    • agentum://pricing, agentum://jurisdictions
  • Prompts: kyb_due_diligence_report, sanctions_escalation_review, vendor_onboarding_check.
  • Interactive Elicitation & Sampling: Inline _meta.elicitation for schema-driven human/agent payment authorization, and _meta.samplingRequest for AI sanctions adjudication.

License

MIT © 2026 Algimantas Krasauskas / Agentum

Source: README.md at commit 6bc5592

Tools

7

resolve_entity

Resolve a company to its official registry record

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

ParametersqueryrequiredcountryverifyVatjurisdictionincludeParentcheckSanctionsincludeOfficersallowPaidSourcesincludeCompanyEventsincludeBeneficialOwners

verify_eu_vat

Validate an EU VAT number against VIES

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

ParametersvatNumberrequired

screen_sanctions

Screen a name against OFAC, EU, UN and UK sanctions lists

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

ParametersnamerequiredcountrythresholdregistrationNumber

check_vendor

Vendor KYB check: registry, VAT and sanctions in one call

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

ParametersnamerequireddomaincountryvatNumberregistrationNumber

verify_bank_payee

Validate an IBAN and its match to the payee's country

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

ParametersibanrequiredpayeeNamepayeeTaxIdexpectedCountry

screen_address

Screen a wallet address against the OFAC sanctioned-address list

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

Parameterschainaddressrequired

batch_resolve

Resolve up to 25 companies to registry records in one call

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

Parametersitemsrequired

Version history

2
  1. v0.2.1LatestNov 7, 2026
  2. v0.2.0Nov 5, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts