Duo Data Utilities: IBAN, ISIN, VAT & Tax ID, Barcode, Timezone, Geo APIs

Official33 tools

by hiesem · TypeScript

IBAN, ISIN, VAT/tax ID, GTIN validation; timezone, geo, text, chain utilities. Pay per call

com.duoleads.api/data-utilities (MCP Server)

The MCP server com.duoleads.api/data-utilities provides 31 pay-per-call data utilities. These utilities cover IDs, time, text, codes, geo, chain, ref, and numbers, and are accessed via x402. The server description indicates the scope of data operations available to calling applications.

🛠️ Key Features

31 pay-per-call data utilities
Data types: IDs, time, text, codes, geo, chain, ref, numbers
Access method: x402

🚀 Use Cases

Fetch or compute ID-related data utilities
Retrieve time-based data utilities
Use utilities for text, codes, geo, chain, ref, and numeric data

⚡ Developer Benefits

Centralized set of 31 pay-per-call utilities
Clear coverage of multiple data categories (IDs, time, text, codes, geo, chain, ref, numbers)
Consistent integration via x402

⚠️ Limitations

Only the described utility categories are supported (as stated: IDs, time, text, codes, geo, chain, ref, numbers)
No additional capabilities, tools, or behaviors are provided beyond the x402-based pay-per-call utilities described

Topics

ai-agentsibanisinmcpvatx402barcodechecksumcusipgeohashgtiniban-validatorjwtkybmcp-serverpay-per-calltimezoneusdcvat-validationisin-validator

Captured live from the server via tools/list.

vat_tax_id_validate

VAT, tax ID and national ID validator: check a national identity, tax or company registration number against its country's official checksum rule. Covers 23 countries including NL BSN, ES NIF/NIE/CIF, IT codice fiscale, FR SIREN/SIRET, DE Steuer-ID, BE/PL/CZ national numbers, SE/NO/DK/FI personal numbers, BR CPF/CNPJ, AU ABN/TFN, UK NINo, IE PPS, US NPI/EIN. Structure and check digit only, no registry lookup; the number is never stored (logs keep only its length and character types). Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters3

country	string	required	ISO 3166-1 alpha-2 country code, case-insensitive. One of the 23 supported countries; the United Kingdom is accepted as UK or GB (the response echoes what you sent). Accepted: one of the 23 supported ISO 3166-1 alpha-2 codes.
kind	string	required	Identifier type for that country, e.g. bsn, nif, cf, cpf. Accepted: an identifier kind supported for the country.
value	string	required	The identifier. Separators (space . - /) are stripped before checking. Accepted: at most 64 characters.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, case-insensitive. One of the 23 supported countries; the United Kingdom is accepted as UK or GB (the response echoes what you sent). Accepted: one of the 23 supported ISO 3166-1 alpha-2 codes."
    },
    "kind": {
      "type": "string",
      "description": "Identifier type for that country, e.g. bsn, nif, cf, cpf. Accepted: an identifier kind supported for the country."
    },
    "value": {
      "type": "string",
      "description": "The identifier. Separators (space . - /) are stripped before checking. Accepted: at most 64 characters."
    }
  },
  "required": [
    "country",
    "kind",
    "value"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

gtin_barcode_validate

GTIN barcode validator: validate and convert GS1 identifiers: GTIN-8, GTIN-12 (UPC-A), GTIN-13 (EAN-13), GTIN-14, GLN and SSCC. Returns the check-digit verdict, the computed correct check digit, the GTIN-14 form with its indicator digit, and conversion between GTIN-8, -12, -13 and -14. No company-prefix split is returned: GS1's prefix-length table is no longer public data. Also computes a missing check digit from a partial code. Structure only, no product database. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters3

op	string	optional	validate (default), checkdigit (compute the missing final digit) or convert. Accepted: validate, checkdigit, convert.
value	string	required	GS1 code, digits with optional spaces or hyphens. For op=checkdigit, omit the final digit. Accepted: 8, 12, 13, 14 or 18 digits.
to	string	optional	Target format. Required when op=convert. Accepted: gtin8, gtin12, gtin13, gtin14.

Raw schema

{
  "type": "object",
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "validate",
        "checkdigit",
        "convert"
      ],
      "description": "validate (default), checkdigit (compute the missing final digit) or convert. Accepted: validate, checkdigit, convert."
    },
    "value": {
      "type": "string",
      "description": "GS1 code, digits with optional spaces or hyphens. For op=checkdigit, omit the final digit. Accepted: 8, 12, 13, 14 or 18 digits."
    },
    "to": {
      "type": "string",
      "enum": [
        "gtin8",
        "gtin12",
        "gtin13",
        "gtin14"
      ],
      "description": "Target format. Required when op=convert. Accepted: gtin8, gtin12, gtin13, gtin14."
    }
  },
  "required": [
    "value"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

isin_cusip_sedol_validate

ISIN validator plus CUSIP, SEDOL and FIGI check digits: validate the check digit of a financial security identifier (ISIN per ISO 6166). Returns the verdict, the computed correct check character, and for an ISIN the issuing country prefix and the embedded NSIN. Also builds an ISIN from a country code plus a 9-character NSIN. Format and checksum only, no security master lookup. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters4

op	string	optional	validate (default) or build-isin. Accepted: validate, build-isin.
value	string	optional	ISIN, CUSIP, SEDOL or FIGI to validate. Required when op=validate. Accepted: an alphanumeric security identifier of at most 24 characters.
country	string	optional	ISO 3166-1 alpha-2 code or XS. Required when op=build-isin. Accepted: at most 16 characters.
nsin	string	optional	Exactly 9 alphanumeric characters. Required when op=build-isin. Accepted: exactly 9 alphanumeric characters.

Raw schema

{
  "type": "object",
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "validate",
        "build-isin"
      ],
      "description": "validate (default) or build-isin. Accepted: validate, build-isin."
    },
    "value": {
      "type": "string",
      "description": "ISIN, CUSIP, SEDOL or FIGI to validate. Required when op=validate. Accepted: an alphanumeric security identifier of at most 24 characters."
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code or XS. Required when op=build-isin. Accepted: at most 16 characters."
    },
    "nsin": {
      "type": "string",
      "description": "Exactly 9 alphanumeric characters. Required when op=build-isin. Accepted: exactly 9 alphanumeric characters."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

iban_validate

IBAN validator: validate an IBAN's length for its country, permitted character classes per field, and the ISO 7064 mod-97-10 check digits. Returns the verdict with a specific failure reason, the electronic and print formats, and the decomposed bank code, branch code and account number according to that country's registered layout. Covers the 89 countries of the SWIFT IBAN registry. Structure and checksum only, it does not confirm the account exists. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters1

iban

string

required

The IBAN. Spaces and non-breaking spaces are stripped; lowercase is accepted and uppercased. Accepted: an IBAN of at most 64 characters.

Raw schema

{
  "type": "object",
  "properties": {
    "iban": {
      "type": "string",
      "description": "The IBAN. Spaces and non-breaking spaces are stripped; lowercase is accepted and uppercased. Accepted: an IBAN of at most 64 characters."
    }
  },
  "required": [
    "iban"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

iban_generate

IBAN generator: construct an IBAN from a country code and the domestic account parts, computing the ISO 7064 mod-97-10 check digits. Takes a single BBAN string or named parts (bank code, branch code, account number); digit fields are left-padded with zeros to the country's registered widths. Returns the IBAN in electronic and print formats with its bank, branch and account parts. Covers the 89 SWIFT registry countries. Named parts work only where they span the whole BBAN; else pass the BBAN. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters5

country	string	required	ISO 3166-1 alpha-2 country code in the SWIFT IBAN registry, case-insensitive. Accepted: an ISO 3166-1 alpha-2 code in the IBAN registry.
bban	string	optional	The whole domestic account number (BBAN), alphanumeric. Use this or bank plus account. Accepted: an alphanumeric BBAN of at most 34 characters.
bank	string	optional	Bank code. Requires account. Accepted: a bank code of at most 16 characters.
branch	string	optional	Branch code, for countries whose layout has a branch field. Accepted: a branch code of at most 16 characters.
account	string	optional	Account number. Requires bank. Accepted: an account number of at most 32 characters.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code in the SWIFT IBAN registry, case-insensitive. Accepted: an ISO 3166-1 alpha-2 code in the IBAN registry."
    },
    "bban": {
      "type": "string",
      "description": "The whole domestic account number (BBAN), alphanumeric. Use this or bank plus account. Accepted: an alphanumeric BBAN of at most 34 characters."
    },
    "bank": {
      "type": "string",
      "description": "Bank code. Requires account. Accepted: a bank code of at most 16 characters."
    },
    "branch": {
      "type": "string",
      "description": "Branch code, for countries whose layout has a branch field. Accepted: a branch code of at most 16 characters."
    },
    "account": {
      "type": "string",
      "description": "Account number. Requires bank. Accepted: an account number of at most 32 characters."
    }
  },
  "required": [
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

timezone_convert

Timezone converter: convert an instant to wall-clock time in a named IANA time zone, or a wall-clock time in a zone back to an instant. Returns the local date and time, the UTC offset in ±HH:MM and seconds, the zone abbreviation, whether DST is in effect, the ISO week date, and the day of year. Handles the ambiguous and skipped local times at DST boundaries explicitly rather than guessing. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters4

zone	string	required	IANA time zone id, e.g. Europe/Amsterdam. Accepted: an IANA time zone id, e.g. Europe/Amsterdam.
instant	string	optional	RFC 3339 timestamp or integer Unix seconds/milliseconds. Defaults to now. Mutually exclusive with local. Accepted: RFC 3339 timestamp or integer epoch.
local	string	optional	Wall-clock time YYYY-MM-DDTHH:MM[:SS] in zone, converted back to an instant. Mutually exclusive with instant. Accepted: YYYY-MM-DDTHH:MM[:SS].
ambiguous	string	optional	Only with local: which instant a repeated local time maps to. Default earlier. Accepted: earlier, later, reject.

Raw schema

{
  "type": "object",
  "properties": {
    "zone": {
      "type": "string",
      "description": "IANA time zone id, e.g. Europe/Amsterdam. Accepted: an IANA time zone id, e.g. Europe/Amsterdam."
    },
    "instant": {
      "type": "string",
      "description": "RFC 3339 timestamp or integer Unix seconds/milliseconds. Defaults to now. Mutually exclusive with local. Accepted: RFC 3339 timestamp or integer epoch."
    },
    "local": {
      "type": "string",
      "description": "Wall-clock time YYYY-MM-DDTHH:MM[:SS] in zone, converted back to an instant. Mutually exclusive with instant. Accepted: YYYY-MM-DDTHH:MM[:SS]."
    },
    "ambiguous": {
      "type": "string",
      "enum": [
        "earlier",
        "later",
        "reject"
      ],
      "description": "Only with local: which instant a repeated local time maps to. Default earlier. Accepted: earlier, later, reject."
    }
  },
  "required": [
    "zone"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

dst_transitions

DST transitions: list the daylight-saving time changes for an IANA time zone over a date range: the exact instant of each shift, the offset before and after, and whether local clocks jump forward or back. Returns the current offset and DST state, and the next transition from a given instant. Zones without DST return an empty transition list rather than an error. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters3

zone	string	required	IANA time zone id. Accepted: an IANA time zone id, e.g. Europe/Amsterdam.
from	string	optional	Start of the range: RFC 3339 or YYYY-MM-DD. Default now. Accepted: RFC 3339 timestamp or YYYY-MM-DD.
years	string	optional	Length of the range in years, 1-10. Default 2. Accepted: integer 1-10.

Raw schema

{
  "type": "object",
  "properties": {
    "zone": {
      "type": "string",
      "description": "IANA time zone id. Accepted: an IANA time zone id, e.g. Europe/Amsterdam."
    },
    "from": {
      "type": "string",
      "description": "Start of the range: RFC 3339 or YYYY-MM-DD. Default now. Accepted: RFC 3339 timestamp or YYYY-MM-DD."
    },
    "years": {
      "type": "string",
      "description": "Length of the range in years, 1-10. Default 2. Accepted: integer 1-10."
    }
  },
  "required": [
    "zone"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

business_days_calculate

Business days calculator with a caller-supplied calendar: add or subtract N working days from a date, or count the working days between two dates. The weekend is a weekday mask (Friday-Saturday and Sunday-only weeks work) and holidays are an explicit date list, so nothing depends on a stale holiday table. Returns the result date, the day count and the skipped dates with reasons. The skipped list is capped at 1,000 entries (skipped_truncated flags it); skipped_total is always exact. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters7

op	string	optional	add (default) N business days to from, or count business days between from and to. Accepted: add, count.
from	string	required	Start date, YYYY-MM-DD. Accepted: a calendar date as YYYY-MM-DD.
days	string	optional	Business days to add, -3650 to 3650. Required when op=add. Accepted: integer between -3650 and 3650.
to	string	optional	End date YYYY-MM-DD, may precede from. Required when op=count. Accepted: a calendar date as YYYY-MM-DD.
weekend	string	optional	Comma-separated weekday names or ISO numbers. Default sat,sun. Empty string = no weekend. Accepted: comma-separated weekday names (mon..sun) or ISO numbers 1-7.
holidays	string	optional	Comma-separated YYYY-MM-DD holiday dates. Accepted: comma-separated YYYY-MM-DD dates, at most 2048 characters.
inclusive	string	optional	For op=count: start (default, half-open [from, to)), both or neither. Accepted: start, both, neither.

Raw schema

{
  "type": "object",
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "add",
        "count"
      ],
      "description": "add (default) N business days to from, or count business days between from and to. Accepted: add, count."
    },
    "from": {
      "type": "string",
      "description": "Start date, YYYY-MM-DD. Accepted: a calendar date as YYYY-MM-DD."
    },
    "days": {
      "type": "string",
      "description": "Business days to add, -3650 to 3650. Required when op=add. Accepted: integer between -3650 and 3650."
    },
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD, may precede from. Required when op=count. Accepted: a calendar date as YYYY-MM-DD."
    },
    "weekend": {
      "type": "string",
      "description": "Comma-separated weekday names or ISO numbers. Default sat,sun. Empty string = no weekend. Accepted: comma-separated weekday names (mon..sun) or ISO numbers 1-7."
    },
    "holidays": {
      "type": "string",
      "description": "Comma-separated YYYY-MM-DD holiday dates. Accepted: comma-separated YYYY-MM-DD dates, at most 2048 characters."
    },
    "inclusive": {
      "type": "string",
      "enum": [
        "start",
        "both",
        "neither"
      ],
      "description": "For op=count: start (default, half-open [from, to)), both or neither. Accepted: start, both, neither."
    }
  },
  "required": [
    "from"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rrule_expand

RRULE expander: expand an RFC 5545 recurrence rule into concrete occurrence timestamps. Accepts an RRULE string with DTSTART, an IANA time zone, and optional EXDATE and RDATE lists, and returns up to 200 occurrences as both local wall-clock times and UTC instants. Supports FREQ, INTERVAL, COUNT, UNTIL, BYDAY, BYMONTHDAY, BYMONTH, BYSETPOS and WKST. Occurrences moved by a DST gap carry gap: true. Rules needing over 50,000 candidate evaluations are rejected. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters7

rrule	string	required	RFC 5545 RRULE, e.g. FREQ=MONTHLY;BYDAY=-1FR;COUNT=6. Accepted: at most 512 characters.
dtstart	string	required	First occurrence, YYYY-MM-DDTHH:MM:SS local to zone. Accepted: YYYY-MM-DDTHH:MM:SS.
zone	string	required	IANA time zone id. Accepted: an IANA time zone id, e.g. Europe/Amsterdam.
count	string	optional	Maximum occurrences to return, 1-200. Default 20. Accepted: integer 1-200.
after	string	optional	RFC 3339 instant; skip occurrences before it. Accepted: RFC 3339 timestamp.
exdate	string	optional	Comma-separated local datetimes to exclude. Accepted: at most 1024 characters.
rdate	string	optional	Comma-separated local datetimes to add. Accepted: at most 1024 characters.

Raw schema

{
  "type": "object",
  "properties": {
    "rrule": {
      "type": "string",
      "description": "RFC 5545 RRULE, e.g. FREQ=MONTHLY;BYDAY=-1FR;COUNT=6. Accepted: at most 512 characters."
    },
    "dtstart": {
      "type": "string",
      "description": "First occurrence, YYYY-MM-DDTHH:MM:SS local to zone. Accepted: YYYY-MM-DDTHH:MM:SS."
    },
    "zone": {
      "type": "string",
      "description": "IANA time zone id. Accepted: an IANA time zone id, e.g. Europe/Amsterdam."
    },
    "count": {
      "type": "string",
      "description": "Maximum occurrences to return, 1-200. Default 20. Accepted: integer 1-200."
    },
    "after": {
      "type": "string",
      "description": "RFC 3339 instant; skip occurrences before it. Accepted: RFC 3339 timestamp."
    },
    "exdate": {
      "type": "string",
      "description": "Comma-separated local datetimes to exclude. Accepted: at most 1024 characters."
    },
    "rdate": {
      "type": "string",
      "description": "Comma-separated local datetimes to add. Accepted: at most 1024 characters."
    }
  },
  "required": [
    "rrule",
    "dtstart",
    "zone"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calendar_convert

Calendar converter: convert a Gregorian date to other calendar systems: Islamic (both the tabular civil calendar and the Umm al-Qura variant), Hebrew, Japanese imperial era, Republic of China, Buddhist and Persian. Also computes Easter Sunday for a year in both the Gregorian and Julian reckonings. Uses the calendar support built into the runtime, with the algorithm named in every response. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters5

op	string	optional	convert (default) a Gregorian date, or easter for a year. Accepted: convert, easter.
date	string	optional	Gregorian date YYYY-MM-DD. Required when op=convert. Accepted: a calendar date as YYYY-MM-DD.
to	string	optional	Comma-separated calendar ids: islamic, islamic-umalqura, hebrew, japanese, roc, buddhist, persian. Default all. Accepted: islamic, islamic-umalqura, hebrew, japanese, roc, buddhist, persian.
year	string	optional	Year for op=easter, 326-9999. Accepted: integer 326-9999.
rite	string	optional	Easter reckoning: western (default) or eastern. Accepted: western, eastern.

Raw schema

{
  "type": "object",
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "convert",
        "easter"
      ],
      "description": "convert (default) a Gregorian date, or easter for a year. Accepted: convert, easter."
    },
    "date": {
      "type": "string",
      "description": "Gregorian date YYYY-MM-DD. Required when op=convert. Accepted: a calendar date as YYYY-MM-DD."
    },
    "to": {
      "type": "string",
      "description": "Comma-separated calendar ids: islamic, islamic-umalqura, hebrew, japanese, roc, buddhist, persian. Default all. Accepted: islamic, islamic-umalqura, hebrew, japanese, roc, buddhist, persian."
    },
    "year": {
      "type": "string",
      "description": "Year for op=easter, 326-9999. Accepted: integer 326-9999."
    },
    "rite": {
      "type": "string",
      "enum": [
        "western",
        "eastern"
      ],
      "description": "Easter reckoning: western (default) or eastern. Accepted: western, eastern."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

slug_generate

Slug generator: turn arbitrary text into a URL-safe slug. Decomposes accents, transliterates German umlauts, Scandinavian and Turkish letters, the ligatures that lose meaning under plain NFD, and Cyrillic (Russian, Ukrainian, Belarusian, Bulgarian, Serbian, Macedonian; language from lang or inferred from the letters). Lowercases, collapses separators, truncates on a word boundary. Returns the slug plus what was removed. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters5

text	string	required	Text to slugify, at most 2048 characters. Accepted: at most 2048 characters.
separator	string	optional	Separator: - (default), _, . or empty. Accepted: -, _, . or empty.
max	string	optional	Maximum slug length 1-512, default 96. Truncates at the last complete word. Accepted: integer 1-512.
case	string	optional	lower (default), preserve or upper. Accepted: lower, preserve, upper.
lang	string	optional	ISO 639-1 code for locale-sensitive folding (de: ü->ue) and the Cyrillic table (ru, uk, be, bg, sr, mk). Default locale-neutral; for Cyrillic the language is then inferred from letters unique to Ukrainian, Belarusian, Serbian or Macedonian, else Russian BGN/PCGN letters with ISO 9 (accents folded) for the rest. Accepted: an ISO 639-1 language code.

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Text to slugify, at most 2048 characters. Accepted: at most 2048 characters."
    },
    "separator": {
      "type": "string",
      "enum": [
        "-",
        "_",
        ".",
        ""
      ],
      "description": "Separator: - (default), _, . or empty. Accepted: -, _, . or empty."
    },
    "max": {
      "type": "string",
      "description": "Maximum slug length 1-512, default 96. Truncates at the last complete word. Accepted: integer 1-512."
    },
    "case": {
      "type": "string",
      "enum": [
        "lower",
        "preserve",
        "upper"
      ],
      "description": "lower (default), preserve or upper. Accepted: lower, preserve, upper."
    },
    "lang": {
      "type": "string",
      "description": "ISO 639-1 code for locale-sensitive folding (de: ü->ue) and the Cyrillic table (ru, uk, be, bg, sr, mk). Default locale-neutral; for Cyrillic the language is then inferred from letters unique to Ukrainian, Belarusian, Serbian or Macedonian, else Russian BGN/PCGN letters with ISO 9 (accents folded) for the rest. Accepted: an ISO 639-1 language code."
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cyrillic_transliterate

Cyrillic transliteration to Latin using a named standard: ISO 9:1995 (one-to-one, with diacritics, covering the full standard: Russian, other Slavic, historic and non-Slavic Cyrillic letters) or BGN/PCGN, which is the Russian system only (Ukrainian, Serbian and other letters are passed through unmapped). Returns the transliteration, the source script, the standard, the mapped fraction and the unmapped characters. Other scripts are rejected with UNSUPPORTED_VALUE. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters4

text	string	required	Text to transliterate, at most 2048 characters. Accepted: at most 2048 characters.
from	string	optional	Source script name (cyrillic), or auto (default). Accepted: cyrillic or auto.
standard	string	optional	Romanisation standard: iso-9 (default; all ISO 9:1995 Cyrillic letters) or bgn-pcgn (BGN/PCGN Russian system, Russian letters only). Accepted: iso-9 or bgn-pcgn (Russian letters only) for cyrillic.
case	string	optional	preserve (default), lower or upper. Accepted: preserve, lower, upper.

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Text to transliterate, at most 2048 characters. Accepted: at most 2048 characters."
    },
    "from": {
      "type": "string",
      "description": "Source script name (cyrillic), or auto (default). Accepted: cyrillic or auto."
    },
    "standard": {
      "type": "string",
      "description": "Romanisation standard: iso-9 (default; all ISO 9:1995 Cyrillic letters) or bgn-pcgn (BGN/PCGN Russian system, Russian letters only). Accepted: iso-9 or bgn-pcgn (Russian letters only) for cyrillic."
    },
    "case": {
      "type": "string",
      "enum": [
        "preserve",
        "lower",
        "upper"
      ],
      "description": "preserve (default), lower or upper. Accepted: preserve, lower, upper."
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

unicode_confusables_check

Unicode normalization and confusables check: apply NFC, NFD, NFKC or NFKD, report which forms a string is already in, list the scripts present (all Unicode scripts), and flag confusable and homoglyph characters — Cyrillic а in a Latin word, fullwidth or mathematical look-alikes, all-look-alike words — plus zero-width joiners, bidirectional overrides, invisible and blank characters. Returns per-character detail with code points, names and the ASCII character each imitates. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters3

text	string	required	Text to analyse, at most 1024 characters. Accepted: at most 1024 characters.
form	string	optional	Normalisation form to apply, default nfc. Accepted: nfc, nfd, nfkc or nfkd.
detail	string	optional	summary (default) or full per-code-point detail (capped at 256 entries). Accepted: summary, full.

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Text to analyse, at most 1024 characters. Accepted: at most 1024 characters."
    },
    "form": {
      "type": "string",
      "enum": [
        "nfc",
        "nfd",
        "nfkc",
        "nfkd"
      ],
      "description": "Normalisation form to apply, default nfc. Accepted: nfc, nfd, nfkc or nfkd."
    },
    "detail": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "description": "summary (default) or full per-code-point detail (capped at 256 entries). Accepted: summary, full."
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

string_similarity

String similarity: compare two strings and return every standard measure in one call: Levenshtein and Damerau-Levenshtein edit distance, normalised similarity, Jaro and Jaro-Winkler, longest common subsequence, Dice coefficient on character bigrams, and the Soundex, Metaphone and NYSIIS phonetic keys of each string. Optional case folding, accent folding and whitespace normalisation before comparison. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters4

a	string	required	First string, at most 512 characters. Accepted: at most 512 characters.
b	string	required	Second string, at most 512 characters. Accepted: at most 512 characters.
fold	string	optional	Comma-separated folds before comparing: case, accents, space, punct. Default case. Accepted: comma-separated subset of case, accents, space, punct.
only	string	optional	Comma-separated measure names to compute: levenshtein, damerau_levenshtein, normalised_similarity, jaro, jaro_winkler, lcs_length, dice, phonetic (all three keys), soundex, metaphone, nysiis. Default all. Accepted: comma-separated subset of levenshtein, damerau_levenshtein, normalised_similarity, jaro, jaro_winkler, lcs_length, dice, phonetic, soundex, metaphone, nysiis.

Raw schema

{
  "type": "object",
  "properties": {
    "a": {
      "type": "string",
      "description": "First string, at most 512 characters. Accepted: at most 512 characters."
    },
    "b": {
      "type": "string",
      "description": "Second string, at most 512 characters. Accepted: at most 512 characters."
    },
    "fold": {
      "type": "string",
      "description": "Comma-separated folds before comparing: case, accents, space, punct. Default case. Accepted: comma-separated subset of case, accents, space, punct."
    },
    "only": {
      "type": "string",
      "description": "Comma-separated measure names to compute: levenshtein, damerau_levenshtein, normalised_similarity, jaro, jaro_winkler, lcs_length, dice, phonetic (all three keys), soundex, metaphone, nysiis. Default all. Accepted: comma-separated subset of levenshtein, damerau_levenshtein, normalised_similarity, jaro, jaro_winkler, lcs_length, dice, phonetic, soundex, metaphone, nysiis."
    }
  },
  "required": [
    "a",
    "b"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

url_parse

URL parser: parse and canonicalise a URL, and extract its registrable domain using the Public Suffix List — the part an agent needs to decide whether two URLs belong to the same owner. Returns scheme, host, port, path, decoded query parameters and fragment, the public suffix, the registrable domain (eTLD+1), the subdomain, whether the suffix is ICANN or private, plus a canonical form with default port, dot-segments and percent-encoding normalised. unicode_host uses WHATWG/UTS 46 (non-strict). Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters2

url	string	required	Absolute URL, or a bare hostname (https:// assumed). Accepted: an absolute URL, or a hostname.
base	string	optional	Base URL to resolve url against as a relative reference. Accepted: an absolute URL.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Absolute URL, or a bare hostname (https:// assumed). Accepted: an absolute URL, or a hostname."
    },
    "base": {
      "type": "string",
      "description": "Base URL to resolve url against as a relative reference. Accepted: an absolute URL."
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

punycode_convert

Punycode converter: convert internationalised domain names between Unicode and ASCII punycode in either direction, label by label, and validate each label against IDNA2008: length, leading and trailing hyphens, the hyphen-hyphen rule at positions 3 and 4, disallowed code points and bidirectional rules. Returns both forms, the per-label breakdown and the first rule violated. Strict mode is IDNA2008 (UTS 46 non-transitional); it may reject names /v1/code/url displays. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters3

domain	string	required	Domain name in Unicode or punycode form. Accepted: at most 512 characters.
to	string	optional	ascii, unicode or both (default). Validated only: the response always carries both forms. Accepted: ascii, unicode, both.
strict	string	optional	true (default) applies IDNA2008 strictly; false uses UTS 46 transitional (IDNA2003-compatible) processing, which maps e.g. ß to ss; current browsers and /v1/code/url use non-transitional processing, so its output can differ from them. Accepted: true or false.

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain name in Unicode or punycode form. Accepted: at most 512 characters."
    },
    "to": {
      "type": "string",
      "enum": [
        "ascii",
        "unicode",
        "both"
      ],
      "description": "ascii, unicode or both (default). Validated only: the response always carries both forms. Accepted: ascii, unicode, both."
    },
    "strict": {
      "type": "string",
      "enum": [
        "true",
        "false"
      ],
      "description": "true (default) applies IDNA2008 strictly; false uses UTS 46 transitional (IDNA2003-compatible) processing, which maps e.g. ß to ss; current browsers and /v1/code/url use non-transitional processing, so its output can differ from them. Accepted: true or false."
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

semver_compare

Semver parser and comparator: parse a semantic version into major, minor, patch, prerelease and build parts; compare two versions by precedence including prerelease ordering; or test whether a version satisfies a range expression using caret, tilde, hyphen, x-ranges and comparator sets. Returns the parsed structure, the comparison result and the reason a range did not match. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters6

op	string	optional	parse (default), compare, satisfies or sort. Accepted: parse, compare, satisfies, sort.
version	string	optional	Version to parse (op=parse) or test (op=satisfies). Accepted: at most 256 characters.
a	string	optional	First version for op=compare. Accepted: at most 256 characters.
b	string	optional	Second version for op=compare. Accepted: at most 256 characters.
range	string	optional	Range expression for op=satisfies, e.g. ^1.2.0. Accepted: at most 256 characters.
versions	string	optional	Comma-separated versions for op=sort, at most 100. Accepted: at most 100 versions.

Raw schema

{
  "type": "object",
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "parse",
        "compare",
        "satisfies",
        "sort"
      ],
      "description": "parse (default), compare, satisfies or sort. Accepted: parse, compare, satisfies, sort."
    },
    "version": {
      "type": "string",
      "description": "Version to parse (op=parse) or test (op=satisfies). Accepted: at most 256 characters."
    },
    "a": {
      "type": "string",
      "description": "First version for op=compare. Accepted: at most 256 characters."
    },
    "b": {
      "type": "string",
      "description": "Second version for op=compare. Accepted: at most 256 characters."
    },
    "range": {
      "type": "string",
      "description": "Range expression for op=satisfies, e.g. ^1.2.0. Accepted: at most 256 characters."
    },
    "versions": {
      "type": "string",
      "description": "Comma-separated versions for op=sort, at most 100. Accepted: at most 100 versions."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

hash_generate

Hash generator: compute a cryptographic digest of supplied data: SHA-256, SHA-384, SHA-512, SHA-1, SHA3-256, SHA3-512, Keccak-256, BLAKE2b-256 and BLAKE2b-512, plus HMAC with any of them. Input is UTF-8 text, base64 or hex bytes; output is hex, base64, base64url or base32. Returns the digest, the byte length of the input, and the exact algorithm identifier used. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters6

algo	string	required	Digest algorithm. Accepted: sha256, sha384, sha512, sha1, sha3-256, sha3-512, keccak256, blake2b-256, blake2b-512.
data	string	required	Input data, interpreted per encoding. At most 8192 characters. An empty value hashes the empty string. Accepted: at most 8192 characters.
encoding	string	optional	Encoding of data: utf8 (default), base64, base64url or hex. Accepted: utf8, base64, base64url, hex.
out	string	optional	Digest output encoding: hex (default), base64, base64url or base32. Accepted: hex, base64, base64url, base32.
hmac_key	string	optional	If present, computes HMAC with this key. Accepted: at most 512 characters.
hmac_key_encoding	string	optional	Encoding of hmac_key, as encoding. Accepted: utf8, base64, base64url, hex.

Raw schema

{
  "type": "object",
  "properties": {
    "algo": {
      "type": "string",
      "enum": [
        "sha256",
        "sha384",
        "sha512",
        "sha1",
        "sha3-256",
        "sha3-512",
        "keccak256",
        "blake2b-256",
        "blake2b-512"
      ],
      "description": "Digest algorithm. Accepted: sha256, sha384, sha512, sha1, sha3-256, sha3-512, keccak256, blake2b-256, blake2b-512."
    },
    "data": {
      "type": "string",
      "description": "Input data, interpreted per encoding. At most 8192 characters. An empty value hashes the empty string. Accepted: at most 8192 characters."
    },
    "encoding": {
      "type": "string",
      "enum": [
        "utf8",
        "base64",
        "base64url",
        "hex"
      ],
      "description": "Encoding of data: utf8 (default), base64, base64url or hex. Accepted: utf8, base64, base64url, hex."
    },
    "out": {
      "type": "string",
      "enum": [
        "hex",
        "base64",
        "base64url",
        "base32"
      ],
      "description": "Digest output encoding: hex (default), base64, base64url or base32. Accepted: hex, base64, base64url, base32."
    },
    "hmac_key": {
      "type": "string",
      "description": "If present, computes HMAC with this key. Accepted: at most 512 characters."
    },
    "hmac_key_encoding": {
      "type": "string",
      "enum": [
        "utf8",
        "base64",
        "base64url",
        "hex"
      ],
      "description": "Encoding of hmac_key, as encoding. Accepted: utf8, base64, base64url, hex."
    }
  },
  "required": [
    "algo",
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

jwt_decode

JWT decoder: decode a JSON Web Token without verifying it: returns the header, the claims, the signature length and algorithm, and a computed view of the time claims — whether exp has passed, whether nbf is in the future, and the remaining lifetime in seconds against a supplied or current instant. Reports structural problems such as a missing part, invalid base64url or an alg of none. It does not and cannot verify the signature; do not use it to decide trust. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters2

token	string	required	The JWT to decode (not verified). At most 8192 characters. Accepted: at most 8192 characters.
at	string	optional	Instant to evaluate exp/nbf against: RFC 3339 or epoch seconds. Default now. Accepted: RFC 3339 timestamp or integer epoch.

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "The JWT to decode (not verified). At most 8192 characters. Accepted: at most 8192 characters."
    },
    "at": {
      "type": "string",
      "description": "Instant to evaluate exp/nbf against: RFC 3339 or epoch seconds. Default now. Accepted: RFC 3339 timestamp or integer epoch."
    }
  },
  "required": [
    "token"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

geohash_encode_decode

Geohash encoder and decoder: encode a WGS-84 latitude and longitude to a geohash at a chosen precision, or decode a geohash back to its bounding box, centre point and error bounds in metres. Encoding also returns the eight neighbouring cells, which is what a caller needs to do proximity search over a geohash-indexed store without a spatial database. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters5

op	string	optional	encode (default): lat/lon to geohash. decode: geohash to bounding box. Accepted: encode, decode.
lat	string	optional	WGS-84 latitude, -90 to 90. Required when op=encode. Accepted: a number between -90 and 90.
lon	string	optional	WGS-84 longitude, -180 to 180. Required when op=encode. Accepted: a number between -180 and 180.
precision	string	optional	Geohash length 1-12, default 9 (about 4.8 m). Accepted: integer 1-12.
geohash	string	optional	Geohash to decode, 1-12 characters. Required when op=decode. Accepted: base32 geohash alphabet, excluding a, i, l and o.

Raw schema

{
  "type": "object",
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "encode",
        "decode"
      ],
      "description": "encode (default): lat/lon to geohash. decode: geohash to bounding box. Accepted: encode, decode."
    },
    "lat": {
      "type": "string",
      "description": "WGS-84 latitude, -90 to 90. Required when op=encode. Accepted: a number between -90 and 90."
    },
    "lon": {
      "type": "string",
      "description": "WGS-84 longitude, -180 to 180. Required when op=encode. Accepted: a number between -180 and 180."
    },
    "precision": {
      "type": "string",
      "description": "Geohash length 1-12, default 9 (about 4.8 m). Accepted: integer 1-12."
    },
    "geohash": {
      "type": "string",
      "description": "Geohash to decode, 1-12 characters. Required when op=decode. Accepted: base32 geohash alphabet, excluding a, i, l and o."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

plus_code_encode_decode

Plus code (Open Location Code) encoder and decoder: encode coordinates as a plus code at a chosen length, or decode a full code back to its bounding box and centre. Also shortens a full code against a reference coordinate and recovers a shortened code given a reference, which is how plus codes are normally exchanged in text. Returns code length, precision in metres and validity. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters7

op	string	optional	encode (default), decode, shorten or recover. Accepted: encode, decode, shorten, recover.
lat	string	optional	Latitude for op=encode. Accepted: a number between -90 and 90.
lon	string	optional	Longitude for op=encode. Accepted: a number between -180 and 180.
code	string	optional	Plus code for decode, shorten or recover. Accepted: at most 20 characters.
length	string	optional	Integer code length for op=encode: one of 2,4,6,8,10 (default),11,12,13,14,15. Other integers in 2-15 are 400 UNSUPPORTED_VALUE. Accepted: one of 2,4,6,8,10,11,12,13,14,15.
ref_lat	string	optional	Reference latitude for op=shorten/recover. Accepted: a number between -90 and 90.
ref_lon	string	optional	Reference longitude for op=shorten/recover. Accepted: a number between -180 and 180.

Raw schema

{
  "type": "object",
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "encode",
        "decode",
        "shorten",
        "recover"
      ],
      "description": "encode (default), decode, shorten or recover. Accepted: encode, decode, shorten, recover."
    },
    "lat": {
      "type": "string",
      "description": "Latitude for op=encode. Accepted: a number between -90 and 90."
    },
    "lon": {
      "type": "string",
      "description": "Longitude for op=encode. Accepted: a number between -180 and 180."
    },
    "code": {
      "type": "string",
      "description": "Plus code for decode, shorten or recover. Accepted: at most 20 characters."
    },
    "length": {
      "type": "string",
      "description": "Integer code length for op=encode: one of 2,4,6,8,10 (default),11,12,13,14,15. Other integers in 2-15 are 400 UNSUPPORTED_VALUE. Accepted: one of 2,4,6,8,10,11,12,13,14,15."
    },
    "ref_lat": {
      "type": "string",
      "description": "Reference latitude for op=shorten/recover. Accepted: a number between -90 and 90."
    },
    "ref_lon": {
      "type": "string",
      "description": "Reference longitude for op=shorten/recover. Accepted: a number between -180 and 180."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

point_in_polygon

Point in polygon check and GeoJSON geometry: point-in-polygon with correct hole handling, bounding box, centroid, signed area in square metres, perimeter length, and ring winding order for a geometry supplied in the request. Accepts Polygon and MultiPolygon, and a GeoJSON Feature wrapping either. Area and length are geodesic on the WGS-84 ellipsoid, correct at any latitude; containment is planar in lon/lat. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters4

geometry	string	required	URL-encoded GeoJSON Polygon, MultiPolygon or a Feature wrapping one. At most 3072 characters and 2000 coordinate pairs. Accepted: valid GeoJSON.
lat	string	optional	Point latitude; with lon, runs the containment test. Accepted: a number between -90 and 90.
lon	string	optional	Point longitude; with lat, runs the containment test. Accepted: a number between -180 and 180.
ops	string	optional	Comma-separated subset of contains,bbox,centroid,area,perimeter,winding. Default all. Accepted: comma-separated subset of contains, bbox, centroid, area, perimeter, winding.

Raw schema

{
  "type": "object",
  "properties": {
    "geometry": {
      "type": "string",
      "description": "URL-encoded GeoJSON Polygon, MultiPolygon or a Feature wrapping one. At most 3072 characters and 2000 coordinate pairs. Accepted: valid GeoJSON."
    },
    "lat": {
      "type": "string",
      "description": "Point latitude; with lon, runs the containment test. Accepted: a number between -90 and 90."
    },
    "lon": {
      "type": "string",
      "description": "Point longitude; with lat, runs the containment test. Accepted: a number between -180 and 180."
    },
    "ops": {
      "type": "string",
      "description": "Comma-separated subset of contains,bbox,centroid,area,perimeter,winding. Default all. Accepted: comma-separated subset of contains, bbox, centroid, area, perimeter, winding."
    }
  },
  "required": [
    "geometry"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

geo_distance

Distance calculator: distance and direction between WGS-84 coordinates: geodesic distance by Vincenty with a haversine fallback, initial and final bearing, the midpoint, and the destination point reached from a start point on a given bearing and distance. Also computes the cumulative length of a supplied coordinate path. Results in metres, kilometres, nautical miles and miles. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters9

op	string	optional	distance (default), destination, midpoint or path. Accepted: distance, destination, midpoint, path.
lat1	string	optional	Start latitude. Accepted: a number between -90 and 90.
lon1	string	optional	Start longitude. Accepted: a number between -180 and 180.
lat2	string	optional	End latitude. Accepted: a number between -90 and 90.
lon2	string	optional	End longitude. Accepted: a number between -180 and 180.
bearing	string	optional	Initial bearing in degrees for op=destination. Accepted: number 0-360.
distance_m	string	optional	Distance in metres for op=destination, 0 to 1e9 (about 25 Earth circumferences); larger values are 400 INVALID_PARAM. Accepted: a number between 0 and 1e9 (metres).
path	string	optional	Comma-separated lat,lon pairs for op=path, at most 200 points. Accepted: comma-separated lat,lon pairs, at most 200 points.
method	string	optional	vincenty (default, WGS-84) or haversine. Accepted: vincenty, haversine.

Raw schema

{
  "type": "object",
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "distance",
        "destination",
        "midpoint",
        "path"
      ],
      "description": "distance (default), destination, midpoint or path. Accepted: distance, destination, midpoint, path."
    },
    "lat1": {
      "type": "string",
      "description": "Start latitude. Accepted: a number between -90 and 90."
    },
    "lon1": {
      "type": "string",
      "description": "Start longitude. Accepted: a number between -180 and 180."
    },
    "lat2": {
      "type": "string",
      "description": "End latitude. Accepted: a number between -90 and 90."
    },
    "lon2": {
      "type": "string",
      "description": "End longitude. Accepted: a number between -180 and 180."
    },
    "bearing": {
      "type": "string",
      "description": "Initial bearing in degrees for op=destination. Accepted: number 0-360."
    },
    "distance_m": {
      "type": "string",
      "description": "Distance in metres for op=destination, 0 to 1e9 (about 25 Earth circumferences); larger values are 400 INVALID_PARAM. Accepted: a number between 0 and 1e9 (metres)."
    },
    "path": {
      "type": "string",
      "description": "Comma-separated lat,lon pairs for op=path, at most 200 points. Accepted: comma-separated lat,lon pairs, at most 200 points."
    },
    "method": {
      "type": "string",
      "enum": [
        "vincenty",
        "haversine"
      ],
      "description": "vincenty (default, WGS-84) or haversine. Accepted: vincenty, haversine."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crypto_address_validate

Crypto address validator: identify which blockchain an address belongs to and validate its encoding: EVM EIP-55 checksum, Bitcoin base58check and bech32/bech32m with witness version, Solana base58 and on-curve check, Cosmos bech32 with its HRP, Tron, XRP, Litecoin, Dogecoin, Cardano, Polkadot SS58 and Algorand. Returns every chain the address is valid for (ambiguous when several match), the checksummed form for EVM addresses, and the reason a check failed, including unrecognised_format. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters3

address	string	required	Address to identify and validate. Accepted: at most 128 characters.
expect	string	optional	Restrict the check to one chain id. Accepted: evm, bitcoin, solana, cosmos, tron, xrp, cardano, polkadot, algorand, litecoin, dogecoin.
chain_id	string	optional	EVM chain id; enables EIP-1191 chain-salted checksum validation. Accepted: a positive integer chain id.

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Address to identify and validate. Accepted: at most 128 characters."
    },
    "expect": {
      "type": "string",
      "enum": [
        "evm",
        "bitcoin",
        "solana",
        "cosmos",
        "tron",
        "xrp",
        "cardano",
        "polkadot",
        "algorand",
        "litecoin",
        "dogecoin"
      ],
      "description": "Restrict the check to one chain id. Accepted: evm, bitcoin, solana, cosmos, tron, xrp, cardano, polkadot, algorand, litecoin, dogecoin."
    },
    "chain_id": {
      "type": "string",
      "description": "EVM chain id; enables EIP-1191 chain-salted checksum validation. Accepted: a positive integer chain id."
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

solidity_function_selector

Solidity function selector and event topic: compute the Keccak-256 hash of a function or event signature and derive the 4-byte selector and the 32-byte topic. Normalises the signature first — strips parameter names, expands uint to uint256 and the other aliases, flattens tuples — so a signature copied from source code produces the same selector as the canonical form. Also hashes arbitrary text or hex bytes with Keccak-256. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters4

signature	string	optional	Solidity function, event or error signature, e.g. transfer(address to, uint amount). Accepted: at most 1024 characters.
data	string	optional	Alternative to signature: raw data to Keccak-256 hash. Accepted: at most 8192 characters.
encoding	string	optional	Encoding of data: utf8 (default) or hex. Accepted: utf8, hex.
kind	string	optional	function (default), event or error. Accepted: function, event, error.

Raw schema

{
  "type": "object",
  "properties": {
    "signature": {
      "type": "string",
      "description": "Solidity function, event or error signature, e.g. transfer(address to, uint amount). Accepted: at most 1024 characters."
    },
    "data": {
      "type": "string",
      "description": "Alternative to signature: raw data to Keccak-256 hash. Accepted: at most 8192 characters."
    },
    "encoding": {
      "type": "string",
      "enum": [
        "utf8",
        "hex"
      ],
      "description": "Encoding of data: utf8 (default) or hex. Accepted: utf8, hex."
    },
    "kind": {
      "type": "string",
      "enum": [
        "function",
        "event",
        "error"
      ],
      "description": "function (default), event or error. Accepted: function, event, error."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

nuts_region_lookup

NUTS region lookup (EU statistical regions): resolve a NUTS code to its name, country and level, walk up to its parents or down to its children, or search regions by name. Covers all four levels (country, major region, basic region, small region) for the 27 member states and 12 further reporting countries, from the NUTS 2024 classification. Returns the Latin-script and local-language names plus the urbanisation, coastal and mountain typologies. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters5

code	string	optional	NUTS code, 2-5 characters, case-insensitive (level-3 codes may contain letters, e.g. NL32B). A GR or GB prefix is accepted for EL or UK. Accepted: 2 to 5 characters matching ^[A-Z]{2}[0-9A-Z]{0,3}$.
name	string	optional	Substring search on region names, case- and accent-insensitive. Up to 25 matches. Accepted: at most 128 characters.
level	string	optional	Restrict a name search to one level, 0-3. Accepted: integer 0-3.
country	string	optional	ISO 3166-1 alpha-2 country filter (UK/GB and EL/GR both accepted). Accepted: an ISO 3166-1 alpha-2 code.
include	string	optional	Comma-separated: parents, children, typology. Default parents,typology. Accepted: comma-separated subset of parents, children, typology.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "NUTS code, 2-5 characters, case-insensitive (level-3 codes may contain letters, e.g. NL32B). A GR or GB prefix is accepted for EL or UK. Accepted: 2 to 5 characters matching ^[A-Z]{2}[0-9A-Z]{0,3}$."
    },
    "name": {
      "type": "string",
      "description": "Substring search on region names, case- and accent-insensitive. Up to 25 matches. Accepted: at most 128 characters."
    },
    "level": {
      "type": "string",
      "description": "Restrict a name search to one level, 0-3. Accepted: integer 0-3."
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country filter (UK/GB and EL/GR both accepted). Accepted: an ISO 3166-1 alpha-2 code."
    },
    "include": {
      "type": "string",
      "description": "Comma-separated: parents, children, typology. Default parents,typology. Accepted: comma-separated subset of parents, children, typology."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

airport_lookup

Airport lookup by IATA or ICAO code: get the airport's name, city, country, ISO 3166-2 region code, WGS-84 coordinates, elevation and IANA time zone, or find the nearest airports to a coordinate within a radius. Covers every airport worldwide that holds a three-letter IATA code and scheduled service. Returns the code type that matched and the distance in kilometres for proximity results. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters5

code	string	optional	3-letter IATA or 4-letter ICAO code, case-insensitive. Accepted: a 3-letter IATA or 4-letter ICAO code.
near	string	optional	lat,lon to search around. Accepted: lat,lon.
radius_km	string	optional	Search radius in km, 1-1000, default 100. Only with near. Accepted: number 1-1000.
limit	string	optional	Maximum results 1-25, default 5. Only with near. Accepted: integer 1-25.
country	string	optional	ISO 3166-1 alpha-2 filter. Accepted: an ISO 3166-1 alpha-2 code.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "3-letter IATA or 4-letter ICAO code, case-insensitive. Accepted: a 3-letter IATA or 4-letter ICAO code."
    },
    "near": {
      "type": "string",
      "description": "lat,lon to search around. Accepted: lat,lon."
    },
    "radius_km": {
      "type": "string",
      "description": "Search radius in km, 1-1000, default 100. Only with near. Accepted: number 1-1000."
    },
    "limit": {
      "type": "string",
      "description": "Maximum results 1-25, default 5. Only with near. Accepted: integer 1-25."
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 filter. Accepted: an ISO 3166-1 alpha-2 code."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

currency_lookup

Currency lookup by ISO 4217 alphabetic or numeric code: the official English name, minor-unit exponent, fund flag, the smallest cash denomination where it differs from the minor unit, the territories that use it, and historic codes on request. Returns the correct rounding increment for cash amounts, which is what a caller needs to render or settle a price. This route returns currency facts only and never an exchange rate. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters3

code	string	optional	ISO 4217 alpha-3 or 3-digit numeric code. Accepted: a 3-letter alphabetic or 3-digit numeric ISO 4217 code.
country	string	optional	ISO 3166-1 alpha-2; returns the currencies in use there. Accepted: an ISO 3166-1 alpha-2 code.
include	string	optional	Comma-separated: territories, historic. Default none. Accepted: comma-separated subset of territories, historic.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "ISO 4217 alpha-3 or 3-digit numeric code. Accepted: a 3-letter alphabetic or 3-digit numeric ISO 4217 code."
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2; returns the currencies in use there. Accepted: an ISO 3166-1 alpha-2 code."
    },
    "include": {
      "type": "string",
      "description": "Comma-separated: territories, historic. Default none. Accepted: comma-separated subset of territories, historic."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

country_lookup

Country lookup: find a country or territory by ISO 3166-1 alpha-2, alpha-3 or numeric code, or by name, and get the other codes, the official and common English names, the UN M49 region and sub-region, the currencies in use, the country-code TLD, and optionally the full ISO 3166-2 subdivision list with each subdivision's type. Also resolves an ISO 3166-2 subdivision code such as NL-NH directly. Names are matched case- and accent-insensitively. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters3

code	string	optional	ISO 3166-1 alpha-2, alpha-3 or numeric code, or an ISO 3166-2 subdivision code such as NL-NH. Accepted: ISO 3166-1 alpha-2/alpha-3/numeric, or an ISO 3166-2 subdivision code.
name	string	optional	Substring search on country names, case- and accent-insensitive. Accepted: at most 128 characters.
include	string	optional	Comma-separated: subdivisions, m49, currency, tld. Default m49,currency,tld. Accepted: comma-separated subset of subdivisions, m49, currency, tld.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2, alpha-3 or numeric code, or an ISO 3166-2 subdivision code such as NL-NH. Accepted: ISO 3166-1 alpha-2/alpha-3/numeric, or an ISO 3166-2 subdivision code."
    },
    "name": {
      "type": "string",
      "description": "Substring search on country names, case- and accent-insensitive. Accepted: at most 128 characters."
    },
    "include": {
      "type": "string",
      "description": "Comma-separated: subdivisions, m49, currency, tld. Default m49,currency,tld. Accepted: comma-separated subset of subdivisions, m49, currency, tld."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

base_convert

Base converter: convert an integer between any two numeric bases from 2 to 36 (hex, binary, octal and more), with arbitrary precision so values far beyond 2^53 are exact. Accepts an optional sign and common prefixes (0x, 0b, 0o), validates every digit against the source base, and returns the value in the target base, in decimal, and as its bit length and digit count. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters5

value	string	required	Integer to convert; optional sign and 0x/0b/0o prefix. Accepted: at most 1024 characters.
from	string	optional	Source base 2-36, or auto (default) to read a 0x/0b/0o prefix. Accepted: integer 2-36, or 'auto'.
to	string	optional	Target base 2-36, default 10. Accepted: integer 2-36.
case	string	optional	Digit case for bases above 10: lower (default) or upper. Accepted: lower, upper.
prefix	string	optional	Emit 0x/0b/0o where conventional. Default false. Accepted: true or false.

Raw schema

{
  "type": "object",
  "properties": {
    "value": {
      "type": "string",
      "description": "Integer to convert; optional sign and 0x/0b/0o prefix. Accepted: at most 1024 characters."
    },
    "from": {
      "type": "string",
      "description": "Source base 2-36, or auto (default) to read a 0x/0b/0o prefix. Accepted: integer 2-36, or 'auto'."
    },
    "to": {
      "type": "string",
      "description": "Target base 2-36, default 10. Accepted: integer 2-36."
    },
    "case": {
      "type": "string",
      "enum": [
        "lower",
        "upper"
      ],
      "description": "Digit case for bases above 10: lower (default) or upper. Accepted: lower, upper."
    },
    "prefix": {
      "type": "string",
      "enum": [
        "true",
        "false"
      ],
      "description": "Emit 0x/0b/0o where conventional. Default false. Accepted: true or false."
    }
  },
  "required": [
    "value"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

number_to_words

Number to words: spell a number out in English, Dutch, German, French, Spanish, Italian, Portuguese, Polish, Russian, Turkish, Swedish or Japanese, in cardinal, ordinal or currency form. Currency form agrees the number with the currency noun and gives real minor-unit names for 19 currencies (EUR, USD, GBP, CHF, SEK, NOK, DKK, PLN, RUB, TRY, CNY, INR, BRL, MXN, CAD, AUD, NZD, CZK, HUF); any other ISO 4217 code uses a fraction such as 56/100. Values up to 10^15. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters5

value	string	required	Integer or decimal, absolute value below 1e15. Accepted: absolute value below 1e15.
lang	string	optional	Language, ISO 639-1. Default en. Accepted: en, nl, de, fr, es, it, pt, pl, ru, tr, sv, ja.
form	string	optional	cardinal (default), ordinal, currency or year. Accepted: cardinal, ordinal, currency, year.
currency	string	optional	ISO 4217 code. Required when form=currency, rejected otherwise. Accepted: an ISO 4217 alpha-3 code.
case	string	optional	lower (default), sentence or title. Accepted: lower, sentence, title.

Raw schema

{
  "type": "object",
  "properties": {
    "value": {
      "type": "string",
      "description": "Integer or decimal, absolute value below 1e15. Accepted: absolute value below 1e15."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "nl",
        "de",
        "fr",
        "es",
        "it",
        "pt",
        "pl",
        "ru",
        "tr",
        "sv",
        "ja"
      ],
      "description": "Language, ISO 639-1. Default en. Accepted: en, nl, de, fr, es, it, pt, pl, ru, tr, sv, ja."
    },
    "form": {
      "type": "string",
      "enum": [
        "cardinal",
        "ordinal",
        "currency",
        "year"
      ],
      "description": "cardinal (default), ordinal, currency or year. Accepted: cardinal, ordinal, currency, year."
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 code. Required when form=currency, rejected otherwise. Accepted: an ISO 4217 alpha-3 code."
    },
    "case": {
      "type": "string",
      "enum": [
        "lower",
        "sentence",
        "title"
      ],
      "description": "lower (default), sentence or title. Accepted: lower, sentence, title."
    }
  },
  "required": [
    "value"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

statistics_calculate

Statistics calculator for a numeric array in one call: count, sum, mean, median, mode, variance and standard deviation honouring ddof (default 1, the sample form; 0 gives the population form) plus always-population *_population fields, min, max, range, the quartiles and interquartile range, skewness, kurtosis, and any requested percentiles. Percentiles use a named interpolation method so the result is reproducible rather than implementation-defined. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters4

values	string	required	Comma-separated finite numbers, at most 500 values. Accepted: comma-separated finite numbers.
percentiles	string	optional	Comma-separated percentiles 0-100, at most 20. Default 25,50,75. Accepted: numbers between 0 and 100.
method	string	optional	Percentile interpolation (NumPy/R names): linear (default), nearest, lower, higher, midpoint. Accepted: linear, nearest, lower, higher, midpoint.
ddof	string	optional	Delta degrees of freedom for variance/stdev: 1 (default, sample, n-1) or 0 (population, n). The *_population fields are always population. Accepted: integer 0-1.

Raw schema

{
  "type": "object",
  "properties": {
    "values": {
      "type": "string",
      "description": "Comma-separated finite numbers, at most 500 values. Accepted: comma-separated finite numbers."
    },
    "percentiles": {
      "type": "string",
      "description": "Comma-separated percentiles 0-100, at most 20. Default 25,50,75. Accepted: numbers between 0 and 100."
    },
    "method": {
      "type": "string",
      "enum": [
        "linear",
        "nearest",
        "lower",
        "higher",
        "midpoint"
      ],
      "description": "Percentile interpolation (NumPy/R names): linear (default), nearest, lower, higher, midpoint. Accepted: linear, nearest, lower, higher, midpoint."
    },
    "ddof": {
      "type": "string",
      "description": "Delta degrees of freedom for variance/stdev: 1 (default, sample, n-1) or 0 (population, n). The *_population fields are always population. Accepted: integer 0-1."
    }
  },
  "required": [
    "values"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

money_split

Money split: split a money amount into shares without losing or inventing a cent. Divide evenly into N parts, or by a list of ratios, and the remainder is distributed one minor unit at a time by a named, deterministic rule — largest-remainder, first-wins or last-wins — so the parts always sum exactly to the original. Uses the ISO 4217 minor-unit exponent of the currency, so zero- and three-decimal currencies work (JPY 0, KWD 3); metals and XXX are rejected. Price: $0.05 per successful call, paid over x402 (USDC on Base).

Parameters5

amount	string	required	Decimal amount, absolute value below 1e12. Accepted: a decimal amount with absolute value below 1e12.
currency	string	required	ISO 4217 alpha-3 code. Accepted: an ISO 4217 alpha-3 code.
parts	string	optional	Number of equal parts, 1-1000. One of parts or ratios. Accepted: integer 1-1000.
ratios	string	optional	Comma-separated non-negative ratios, at most 1000, each with at most 15 integer digits and 15 decimal places. One of parts or ratios. Accepted: comma-separated non-negative numbers, at most 1000.
rule	string	optional	Remainder rule: largest-remainder (default), first, last or round-robin. Accepted: largest-remainder, first, last, round-robin.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "string",
      "description": "Decimal amount, absolute value below 1e12. Accepted: a decimal amount with absolute value below 1e12."
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 alpha-3 code. Accepted: an ISO 4217 alpha-3 code."
    },
    "parts": {
      "type": "string",
      "description": "Number of equal parts, 1-1000. One of parts or ratios. Accepted: integer 1-1000."
    },
    "ratios": {
      "type": "string",
      "description": "Comma-separated non-negative ratios, at most 1000, each with at most 15 integer digits and 15 decimal places. One of parts or ratios. Accepted: comma-separated non-negative numbers, at most 1000."
    },
    "rule": {
      "type": "string",
      "enum": [
        "largest-remainder",
        "first",
        "last",
        "round-robin"
      ],
      "description": "Remainder rule: largest-remainder (default), first, last or round-robin. Accepted: largest-remainder, first, last, round-robin."
    }
  },
  "required": [
    "amount",
    "currency"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md9 KBView on GitHub

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
`text.transliterate`	`/v1/text/transliterate`	Cyrillic transliteration to Latin (ISO 9:1995, BGN/PCGN Russian)
`text.unicode`	`/v1/text/unicode`	Unicode normalization (NFC/NFKC), script detection and homoglyph/confusable check
`hash.generate`	`/v1/code/hash`	Hash generator: SHA-256, SHA-512, SHA-3, Keccak-256, BLAKE2 and HMAC digests
`punycode.convert`	`/v1/code/idn`	Punycode converter: IDN domain to ASCII and back, with IDNA2008 label validation
`jwt.decode`	`/v1/code/jwt`	JWT decoder: header, claims and expiry state (no signature verification)
`semver.compare`	`/v1/code/semver`	Semver parser: parse and compare versions, check range satisfaction
`url.parse`	`/v1/code/url`	URL parser: parse, canonicalize and extract the registrable domain (eTLD+1)
`geohash.encodeDecode`	`/v1/geo/geohash`	Geohash encoder and decoder with neighbour cells
`plusCode.encodeDecode`	`/v1/geo/pluscode`	Plus code (Open Location Code) encoder and decoder
`polygon.check`	`/v1/geo/polygon`	Point in polygon check, plus bounding box, centroid and area for GeoJSON
`distance.calculate`	`/v1/geo/distance`	Distance calculator: geodesic distance, bearing and destination point on WGS-84
`cryptoAddress.validate`	`/v1/chain/address`	Crypto address validator: detect the blockchain and verify the checksum (EVM, Bitcoin, Solana and more)
`solidity.selector`	`/v1/chain/selector`	Solidity function selector: Keccak-256, 4-byte selector and event topic from a signature
`airport.lookup`	`/v1/ref/airport`	Airport lookup by IATA or ICAO code: name, coordinates, elevation, time zone; nearest airports
`country.lookup`	`/v1/ref/country`	Country lookup: ISO 3166 codes, currency, TLD, UN region and ISO 3166-2 subdivisions
`currency.lookup`	`/v1/ref/currency`	Currency lookup: ISO 4217 codes, names, minor units and cash rounding
`nuts.lookup`	`/v1/ref/nuts`	NUTS region lookup: EU statistical region codes, names and hierarchy
`money.split`	`/v1/num/allocate`	Money split: allocate an amount into shares with no rounding loss
`base.convert`	`/v1/num/radix`	Base converter: integers between number bases 2 to 36 (hex, binary, octal)
`statistics.calculate`	`/v1/num/stats`	Statistics calculator: mean, median, standard deviation, quartiles and percentiles
`numberWords.convert`	`/v1/num/words`	Number to words in 12 languages, with ordinal and currency forms

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.

python

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.

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.

Install

Tools (33)

vat_tax_id_validategtin_barcode_validateisin_cusip_sedol_validateiban_validateiban_generatetimezone_convertdst_transitionsbusiness_days_calculate

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.duoleads.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "data-utilities": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.duoleads.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

com.duoleads.api/data-utilities (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

vat_tax_id_validate

gtin_barcode_validate

isin_cusip_sedol_validate

iban_validate

iban_generate

timezone_convert

dst_transitions

business_days_calculate

rrule_expand

calendar_convert

slug_generate

cyrillic_transliterate

unicode_confusables_check

string_similarity

url_parse

punycode_convert

semver_compare

hash_generate

jwt_decode

geohash_encode_decode

plus_code_encode_decode

point_in_polygon

geo_distance

crypto_address_validate

solidity_function_selector

nuts_region_lookup

airport_lookup

currency_lookup

country_lookup

base_convert

number_to_words

statistics_calculate

money_split

Install

Quick start

Counterparty check

Methods

MCP

Python

Pricing and the price guard

What this is not

Links

Development

License

Install

Remote endpoint

Related servers