How do I install Duo Data Utilities: IBAN, VAT, ISIN Validation API?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Duo Data Utilities: IBAN, VAT, ISIN Validation API need an API key?

No required environment variable is listed on this record.

What transport does Duo Data Utilities: IBAN, VAT, ISIN Validation API use?

Duo Data Utilities: IBAN, VAT, ISIN Validation API is reached over HTTP.

When was Duo Data Utilities: IBAN, VAT, ISIN Validation API last checked?

Last checked 2026-11-12. IBAN, ISIN, VAT/tax ID, GTIN validation; timezone, geo, text, chain utilities. Pay per call

Duo Data Utilities: IBAN, VAT, ISIN Validati MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.duoleads.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.duoleads.api-data-utilities https://api.duoleads.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.duoleads.api-data-utilities": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.duoleads.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.1.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

IBAN, ISIN, VAT/tax ID and GTIN barcode validation plus 29 more utilities for AI agents. Pay per call ($0.05 USDC on Base via x402), no API key, no signup.

Timezone and DST, geo distance and geohash, hashes and JWT decoding, airport, country, currency and NUTS lookups, money split, base conversion and more. Every call is one HTTP GET, paid per request.

Install

npm install duo-data-utilities viem

viem creates the wallet account that pays. This package also depends on it. Node.js 20 or later.

Python (not on PyPI, install from GitHub):

pip install "git+https://github.com/hiesem/duo-data-utilities#subdirectory=python"

Quick start

import { privateKeyToAccount } from "viem/accounts";
import { createClient } from "duo-data-utilities";

// Your wallet holds USDC on Base. Read the key from the environment, never a literal.
const client = createClient({ account: privateKeyToAccount(process.env.DUO_PAYER_KEY as `0x${string}`) });

const iban = await client.iban.validate({ iban: "NL91 ABNA 0417 1643 00" }); // $0.05
console.log(iban.valid, iban.country); // true NL

Counterparty check

checkCounterparty runs three checks in one call: IBAN (/v1/id/iban), tax ID (/v1/id/national) and country (/v1/ref/country). It costs $0.15.

const check = await client.checkCounterparty({
  iban: "NL91 ABNA 0417 1643 00",
  country: "NL",
  taxIdType: "bsn",
  taxId: "111222333",
});
console.log(check.verdict, check.reasons); // "pass", "fail" or "review"

fail: the IBAN or the tax ID fails its checksum, the country is not an ISO 3166-1 country, or the API rejects an input as malformed.
review: the IBAN country differs from the tax ID country, or the API does not cover that country or tax ID kind.
pass: every check passed.

Structure and checksum only. The check does not query a company register, a bank or a tax authority, and it does not confirm that an account exists. UK is read as GB.

Methods

Every method costs $0.05 per call. Each method's JSDoc gives the route and the parameters. client.call(path, params) calls any route, and client.callWithReceipt(path, params) also returns the settlement receipt.

Method	Route	What it does
`iban.validate`	`/v1/id/iban`	IBAN validator: length, mod-97 check digits, bank/branch/account breakdown (89 countries)
`iban.generate`	`/v1/id/iban-build`	IBAN generator: build an IBAN from country and BBAN or bank/branch/account, computing check digits
`taxId.validate`	`/v1/id/national`	VAT, tax ID and national ID validator: 23 countries, checksum only (VAT formats BE, DE, FR, IT, PL, AT, CH, IE)
`isin.validate`	`/v1/id/security`	ISIN validator plus CUSIP, SEDOL and FIGI check-digit validation; builds an ISIN from an NSIN
`barcode.validate`	`/v1/id/gs1`	GTIN barcode validator: EAN-13, UPC-A (GTIN-12), GTIN-8/14, GLN and SSCC check digits
`timezone.convert`	`/v1/time/zone`	Timezone converter: instant to local time in an IANA time zone and back, with UTC offset and DST state
`timezone.dstTransitions`	`/v1/time/dst`	DST transitions: next daylight-saving time changes for an IANA time zone
`businessDays.calculate`	`/v1/time/business-days`	Business days calculator: add or count working days with your weekend mask and holiday list
`rrule.expand`	`/v1/time/rrule`	RRULE expander: RFC 5545 recurrence rule to concrete occurrence dates
`calendar.convert`	`/v1/time/calendar`	Calendar converter: Gregorian to Hijri, Hebrew, Japanese era, Persian and more, plus Easter date
`text.similarity`	`/v1/text/similarity`	String similarity: Levenshtein, Jaro-Winkler distance and Soundex/Metaphone phonetic keys
`text.slug`	`/v1/text/slug`	Slug generator: Unicode-aware URL slug with transliteration

MCP

The MCP server is at https://api.duoleads.com/mcp (Streamable HTTP). tools/list is free. Each tools/call costs $0.05 and needs an x402-capable client or wallet bridge. See mcp/README.md for Claude Code, Claude Desktop, Cursor, VS Code and AgentCash.

Python

Python 3.10 or later. The client is typed (py.typed) and uses requests with x402's EVM signer. Routes and method names match the TypeScript client, in snake_case.

import os

from eth_account import Account
from duo_data_utilities import DuoClient

client = DuoClient(Account.from_key(os.environ["DUO_PAYER_KEY"]))  # your wallet, never a literal key
print(client.iban.validate(iban="NL91 ABNA 0417 1643 00")["valid"])

check = client.check_counterparty(iban="NL91 ABNA 0417 1643 00", country="NL", tax_id_type="bsn", tax_id="111222333")
print(check.verdict, check.reasons)

DuoClient(account, *, max_price_usd=0.05, timeout=None, pay_to=<service address>) applies the same price guard. Pass session= with a requests.Session that already pays to skip the guard. from_ is the Python name for the from query parameter.

Pricing and the price guard

Every route costs $0.05 per call, paid in USDC on Base (eip155:8453) with x402 v2.
maxPriceUsd defaults to 0.05. Before anything is signed, the client refuses a payment requirement that asks for more than that, a network other than Base, an asset other than Base USDC, or another payee. A refused call makes no payment and throws PriceGuardError.
The client only signs payments to the service's public address 0xCD673f7e1daD254347AEab6be0DEFe8b9C6b3A39 (payTo option; pay_to in Python). Set it if you point baseUrl at another deployment.
The client never retries a paid call on its own.
Plain http:// is refused except for loopback addresses (localhost, 127.0.0.1, [::1]).
With fetch instead of account, you pass a fetch that already pays. The price guard cannot check payments made inside it, so use account to keep the guard.

Examples

Runnable agents in examples/. Each folder has a README with setup, environment variables and cost.

Example	Language	What it does
supplier-onboarding-agent	TypeScript	Supplier / vendor onboarding check: builds and validates IBANs, checks VAT numbers, compares the account holder name. Approve, review or reject per supplier.
kyb-payout-agent-python	Python	KYB payout validation agent with Claude tool use: IBAN, VAT / tax ID, country and name checks, with a spend cap.
mcp-paid-client	TypeScript	MCP client for `https://api.duoleads.com/mcp` that pays each `tools/call` with x402, plus an MCP host config.
node-basic.ts	TypeScript	IBAN, time zone, counterparty check and a settlement receipt in one script.
vercel-ai-sdk-tool.ts	TypeScript	IBAN and counterparty checks as Vercel AI SDK tools.
langchain_tool.py	Python	IBAN and counterparty checks as LangChain tools.
claude-mcp.md		Adding the MCP server to Claude Code.

Every call costs $0.05 in USDC on Base, paid by the wallet you configure. The examples' tests run offline with mocked responses; nothing in CI pays.

User-Agent and privacy

The SDK sends a User-Agent naming the SDK and version; the API stores only a coarse client class, see https://api.duoleads.com/privacy

TypeScript: duo-data-utilities-js/<version> (+https://github.com/hiesem/duo-data-utilities). Override it with createClient({ userAgent }), or append your own product: userAgent: `${SDK_USER_AGENT} my-agent/1.0` .
Python: duo-data-utilities-py/<version> (+https://github.com/hiesem/duo-data-utilities). Override it with DuoClient(..., user_agent=...), or append to duo_data_utilities.USER_AGENT.
In browsers a page cannot set User-Agent, so the client sends none there, and it adds no other header in its place (one would make the browser send a CORS preflight, which the API does not accept). The browser's own User-Agent is sent instead.

What this is not

Not a registry lookup. IBAN, tax ID and VAT checks are structure and checksum only.
Not financial, legal or tax advice. Each response carries a disclaimer.

Development

npm install
npm run generate        # rebuild src/generated.ts from spec/ (npm test checks it is current)
npm run typecheck
npm test
npm run build

spec/ holds the snapshots the code is generated from. See spec/README.md.

License

MIT. See LICENSE.

Duo Data Utilities: IBAN, VAT, ISIN Validation API

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Duo Data Utilities: IBAN, VAT, ISIN Validation API?

Does Duo Data Utilities: IBAN, VAT, ISIN Validation API need an API key?

What transport does Duo Data Utilities: IBAN, VAT, ISIN Validation API use?

When was Duo Data Utilities: IBAN, VAT, ISIN Validation API last checked?

Documentation

Install

Quick start

Counterparty check

Methods

MCP

Python

Pricing and the price guard

Examples

User-Agent and privacy

What this is not

Links

Development

License