Agent Data Tools: Utilities

Official52 tools

by Nutshell2000 · JavaScript

52 tools: JSON repair, CSV, hashes, cron, dates, units, validators. 25 free calls.

MCP Server: io.github.Nutshell2000/agent-data-tools-utilities

This MCP server provides access to a set of data tools. The server is described as offering 52 tools, focused on utilities such as JSON repair, CSV handling, hashes, cron scheduling, dates, units, and validators. It also specifies 25 free calls.

🛠️ Key Features

52 tools total
JSON repair utilities
CSV-related utilities
Hash-related utilities
Cron scheduling utilities
Date utilities
Unit conversion/utilities
Validators

🚀 Use Cases

Repair malformed JSON inputs
Process or validate CSV data
Generate or verify hashes
Schedule or interpret cron-based tasks
Handle date computations or formatting
Convert or manage units
Validate data using built-in validators

⚡ Developer Benefits

Centralized tool access for data-related operations
Includes JSON repair, CSV, hashing, cron, date, unit, and validation utilities
25 free calls available

Topics

agent-skillsai-agentsbasebitcoin-feesmarkdownmcpmcp-serverusdcweb-extractionx402

Captured live from the server via tools/list.

json_validate

Check whether text is valid JSON. Returns valid true/false, the parsed value's type and size, and for invalid input the error message with line and column. Use before parsing an LLM's or an API's output. Example: text={"a":1}. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

text

string

required

The JSON text to check (up to 20,000 characters)

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The JSON text to check (up to 20,000 characters)"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

json_format

Format JSON with indentation (2 or 4 spaces, or tabs) and optionally sorted keys. Returns the formatted text. Use to make machine JSON readable or to normalise it for diffs. Example: text={"b":2,"a":1}, indent=2, sortKeys=true. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters3

text	string	required	The JSON text
indent	string	optional	2 (default), 4 or tab
sortKeys	string	optional	true to sort object keys

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The JSON text"
    },
    "indent": {
      "type": "string",
      "description": "2 (default), 4 or tab"
    },
    "sortKeys": {
      "type": "string",
      "description": "true to sort object keys"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

json_minify

Remove all unnecessary whitespace from JSON and report the size before and after. Use to shrink payloads or prompts. Example: text={ "a" : 1 }. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

text

string

required

The JSON text

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The JSON text"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

json_repair

Fix JSON as LLMs often write it: removes ```json fences and surrounding prose, comments and trailing commas, converts single quotes, quotes bare keys, maps True/False/None, and closes unclosed brackets. Returns the repaired JSON and whether it now parses. Use when an LLM's JSON output fails to parse. Example: text=```json {name: 'Ada', tags: ['x',],} ```. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

text

string

required

The broken JSON text

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The broken JSON text"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

json_to_csv

Convert a JSON array of objects to CSV with a header row built from all keys. Nested values are written as JSON. Use to export API results to a spreadsheet. Example: text=[{"name":"Ada","age":36},{"name":"Alan","age":41}]. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

text

string

required

A JSON array of objects

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "A JSON array of objects"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

csv_to_json

Convert CSV (comma, semicolon, tab or pipe; delimiter detected automatically; quoted fields supported) to a JSON array of objects using the first row as keys. Numbers stay as text unless numbers=true. Use to load spreadsheet exports into an agent. Example: text=name,age Ada,36, numbers=true. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

text	string	required	The CSV text, first row is the header
numbers	string	optional	true to turn numeric cells into numbers

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The CSV text, first row is the header"
    },
    "numbers": {
      "type": "string",
      "description": "true to turn numeric cells into numbers"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

base64_encode

Encode UTF-8 text as standard base64, and also return the URL-safe variant. Use for data URLs, headers and basic auth strings. Example: text=hello world. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

text

string

required

The text to encode

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The text to encode"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

base64_decode

Decode standard or URL-safe base64 to UTF-8 text. Missing padding is tolerated. Use to read encoded headers, tokens and data URLs. Example: text=aGVsbG8gd29ybGQ=. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

text

string

required

The base64 text

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The base64 text"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

url_encode

Percent-encode text for use in a URL query value (encodeURIComponent) and as a full URL (encodeURI). Use when building query strings. Example: text=a b&c=d/é. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

text

string

required

The text to encode

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The text to encode"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

url_decode

Decode percent-encoded text, treating + as a space when plus=true (form encoding). Use to read encoded links and form data. Example: text=a%20b%26c, plus=false. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

text	string	required	The encoded text
plus	string	optional	true to read + as space

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The encoded text"
    },
    "plus": {
      "type": "string",
      "description": "true to read + as space"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

url_parse

Split a URL into protocol, host, port, path, query parameters (as an object), hash and origin, and report whether the host is an IP address. Use to read query parameters or check a link's host. Example: url=https://example.com:8080/a/b?x=1&y=2#top. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

url

string

required

The URL to parse

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The URL to parse"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

hash

Hash UTF-8 text with SHA-256 (default), SHA-1, SHA-384 or SHA-512 and return the digest in hex and base64. Use for checksums, cache keys and deduplication. Example: text=hello, algorithm=sha256. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

text	string	required	The text to hash
algorithm	string	optional	sha256 (default), sha1, sha384 or sha512

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The text to hash"
    },
    "algorithm": {
      "type": "string",
      "description": "sha256 (default), sha1, sha384 or sha512"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

hmac

Compute an HMAC of a message with a key using SHA-256 (default), SHA-1, SHA-384 or SHA-512, in hex and base64. Use to check webhook signatures. The key is used only for this call and is not stored. Example: message=hello, key=secret, algorithm=sha256. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters3

message	string	required	The message
key	string	required	The key
algorithm	string	optional	sha256 (default), sha1, sha384 or sha512

Raw schema

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "The message"
    },
    "key": {
      "type": "string",
      "description": "The key"
    },
    "algorithm": {
      "type": "string",
      "description": "sha256 (default), sha1, sha384 or sha512"
    }
  },
  "required": [
    "message",
    "key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

uuid

Generate 1 to 100 random version-4 UUIDs from a cryptographic random source. Use for IDs, idempotency keys and test data. Example: count=3. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

count

integer

optional

How many (1-100, default 1)

Raw schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many (1-100, default 1)"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

slug

Turn any text into a URL-friendly slug: accents removed (é→e, ß→ss), lower case, non-alphanumerics replaced by a separator (- by default). Use for file names, URLs and IDs. Example: text=Crème Brûlée & Straße!, separator=-. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

text	string	required	The text
separator	string	optional	- (default) or _

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The text"
    },
    "separator": {
      "type": "string",
      "description": "- (default) or _"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

case

Convert text or identifiers between camelCase, PascalCase, snake_case, kebab-case, CONSTANT_CASE, Title Case, Sentence case, UPPER and lower. Handles mixed input like 'userID_value'. Use when renaming fields or generating code identifiers. Example: text=user profile id, to=camel. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

text	string	required	The text
to	string	required	camel, pascal, snake, kebab, constant, title, sentence, upper or lower

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The text"
    },
    "to": {
      "type": "string",
      "description": "camel, pascal, snake, kebab, constant, title, sentence, upper or lower"
    }
  },
  "required": [
    "text",
    "to"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

text_stats

Count characters, words, sentences and paragraphs, estimate reading and speaking time, and compute the Flesch reading-ease score and grade level for English text. Use to check the length and readability of a draft. Example: text=The quick brown fox jumps over the lazy dog. It was not amused.. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

text

string

required

The text

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The text"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

text_extract

Find all email addresses, URLs, phone-number-like strings, hashtags, @mentions and numbers in a text, each list de-duplicated. Use to pull contacts and links out of scraped pages or messages. Example: text=Mail ada@example.com or see https://example.com #news @ada +46 70 123 45 67. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

text

string

required

The text

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The text"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

text_diff

Line-by-line difference between two texts: each line marked as unchanged, removed or added, with counts. Use to see what changed between two versions of a document, config or prompt. Example: a=one two three, b=one 2 three four. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

a	string	required	The original text
b	string	required	The new text

Raw schema

{
  "type": "object",
  "properties": {
    "a": {
      "type": "string",
      "description": "The original text"
    },
    "b": {
      "type": "string",
      "description": "The new text"
    }
  },
  "required": [
    "a",
    "b"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cron_next

Next run times (in UTC) of a standard 5-field cron expression (minute hour day month weekday; ranges, lists, steps and names like MON or JAN supported). Use to check a schedule before deploying it. Example: expr=*/15 9-17 * * MON-FRI, count=5, from=2026-10-19T08:00:00Z. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters3

expr	string	required	The cron expression
count	integer	optional	How many runs (1-50, default 5)
from	string	optional	Start time, ISO (default now)

Raw schema

{
  "type": "object",
  "properties": {
    "expr": {
      "type": "string",
      "description": "The cron expression"
    },
    "count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many runs (1-50, default 5)"
    },
    "from": {
      "type": "string",
      "description": "Start time, ISO (default now)"
    }
  },
  "required": [
    "expr"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

date_diff

Time between two dates or timestamps: total days, weeks, hours, minutes and seconds, a years-months-days breakdown, and the number of weekdays (Monday-Friday) in between. Use for deadlines, ages and durations. Example: from=2026-01-01, to=2026-10-18. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

from	string	required	Start date or ISO timestamp
to	string	required	End date or ISO timestamp

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Start date or ISO timestamp"
    },
    "to": {
      "type": "string",
      "description": "End date or ISO timestamp"
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

date_add

Add (or subtract, with negative numbers) years, months, weeks, days, hours and minutes to a date, or add business days (skipping Saturdays and Sundays). Month ends are clamped (31 Jan + 1 month = 28/29 Feb). Use to compute due dates and expiries. Example: date=2026-01-31, months=1, days=0, businessDays=0. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters4

date	string	required	Start date or ISO timestamp
months	integer	optional	Months to add
days	integer	optional	Days to add
businessDays	integer	optional	Weekdays to add (skips weekends)

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Start date or ISO timestamp"
    },
    "months": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Months to add"
    },
    "days": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Days to add"
    },
    "businessDays": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Weekdays to add (skips weekends)"
    }
  },
  "required": [
    "date"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

date_info

Weekday, ISO week number and week-year, day of the year, quarter, days in the month, leap year, Unix timestamp and whether it is a weekend, for any date. Use for calendar and reporting logic. Example: date=2026-10-18. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

date

string

required

Date or ISO timestamp (default today)

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Date or ISO timestamp (default today)"
    }
  },
  "required": [
    "date"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

unix

Convert a Unix timestamp (seconds or milliseconds, detected automatically) to ISO date and time, or an ISO date to a Unix timestamp. Without input, returns the current time in both forms. Use to read timestamps in logs and APIs. Example: value=1792281600. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

value

string

optional

Unix seconds/milliseconds or an ISO date (default now)

Raw schema

{
  "type": "object",
  "properties": {
    "value": {
      "type": "string",
      "description": "Unix seconds/milliseconds or an ISO date (default now)"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

units_convert

Convert between units of length, mass, volume (incl. US cups and gallons), temperature (c, f, k), speed, area, data size (kB vs KiB), time, energy and pressure. Example units: km, mi, lb, kg, floz, ml, mph, kn, acre, gib, kwh, psi. Use when exact conversions matter. Example: value=10, from=km, to=mi. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters3

value	number	required	The amount
from	string	required	Unit to convert from
to	string	required	Unit to convert to

Raw schema

{
  "type": "object",
  "properties": {
    "value": {
      "type": "number",
      "description": "The amount"
    },
    "from": {
      "type": "string",
      "description": "Unit to convert from"
    },
    "to": {
      "type": "string",
      "description": "Unit to convert to"
    }
  },
  "required": [
    "value",
    "from",
    "to"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

number_words

Write a whole number (up to trillions, negatives allowed) out in English words, e.g. for cheques and invoices. Also returns the cheque form with 'and' cents when given a decimal amount. Use when amounts must be written out in full. Example: number=1234.5. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

number

required

The number, decimals allowed

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "type": "number",
      "description": "The number, decimals allowed"
    }
  },
  "required": [
    "number"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

number_roman

Convert a number (1-3999) to Roman numerals, or Roman numerals back to a number. Give either number or roman. Use for dates, outlines and puzzles. Example: number=2026, roman=MMXXVI. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

number	integer	optional	1 to 3999
roman	string	optional	Roman numerals to read

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "1 to 3999"
    },
    "roman": {
      "type": "string",
      "description": "Roman numerals to read"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

validate_iban

Check an IBAN's format, its country-specific length and its mod-97 check digits, and return it formatted in groups of four. Use before saving bank details or paying out. Example: iban=SE45 5000 0000 0583 9825 7466. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

iban

string

required

The IBAN, spaces allowed

Raw schema

{
  "type": "object",
  "properties": {
    "iban": {
      "type": "string",
      "description": "The IBAN, spaces allowed"
    }
  },
  "required": [
    "iban"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

validate_isbn

Check an ISBN-10 or ISBN-13 check digit and convert valid ISBN-10s to ISBN-13. Hyphens and spaces are ignored. Use before cataloguing or ordering books. Example: isbn=0-306-40615-2. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

isbn

string

required

The ISBN

Raw schema

{
  "type": "object",
  "properties": {
    "isbn": {
      "type": "string",
      "description": "The ISBN"
    }
  },
  "required": [
    "isbn"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

validate_luhn

Check whether a number passes the Luhn (mod 10) algorithm used by card numbers, IMEI numbers and many IDs, and compute the check digit to append. Only the format is checked; nothing is looked up. Use to catch typos in card or ID numbers. Example: number=79927398713. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

number

string

required

Digits, spaces and hyphens allowed

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "description": "Digits, spaces and hyphens allowed"
    }
  },
  "required": [
    "number"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

color

Convert a colour between hex, RGB and HSL, and give its relative luminance and whether black or white text reads better on it. Accepts #rgb, #rrggbb, rgb(r,g,b) and hsl(h,s%,l%). Use for theming and design checks. Example: color=#0f6cbd. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

color

string

required

The colour

Raw schema

{
  "type": "object",
  "properties": {
    "color": {
      "type": "string",
      "description": "The colour"
    }
  },
  "required": [
    "color"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

color_contrast

WCAG 2 contrast ratio between a text colour and a background colour, with pass/fail for AA and AAA at normal and large text sizes. Use to check that a design is readable. Example: fg=#767676, bg=#ffffff. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

fg	string	required	Text colour
bg	string	required	Background colour

Raw schema

{
  "type": "object",
  "properties": {
    "fg": {
      "type": "string",
      "description": "Text colour"
    },
    "bg": {
      "type": "string",
      "description": "Background colour"
    }
  },
  "required": [
    "fg",
    "bg"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ip_cidr

Details of an IPv4 network in CIDR notation: network and broadcast address, first and last usable host, netmask, number of addresses, and whether a given IP falls inside. Use for firewall rules and allowlists. Example: cidr=192.168.1.0/24, ip=192.168.1.77. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

cidr	string	required	IPv4 network in CIDR notation
ip	string	optional	Optional IPv4 address to test for membership

Raw schema

{
  "type": "object",
  "properties": {
    "cidr": {
      "type": "string",
      "description": "IPv4 network in CIDR notation"
    },
    "ip": {
      "type": "string",
      "description": "Optional IPv4 address to test for membership"
    }
  },
  "required": [
    "cidr"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ip_info

Classify an IPv4 or IPv6 address without any lookup: version, whether it is private, loopback, link-local, carrier-grade NAT or public, and its integer and reverse-DNS forms (IPv4). Use to triage IPs in logs or allowlists. Example: ip=10.1.2.3. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

string

required

The IP address

Raw schema

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "The IP address"
    }
  },
  "required": [
    "ip"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

semver

Compare two semantic versions (1.2.3, pre-releases like 2.0.0-rc.1 handled by the SemVer rules) and get which is newer, plus the next major, minor and patch versions of the first. Use to decide whether an upgrade is a major change. Example: a=1.10.0, b=1.9.3. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

a	string	required	First version
b	string	required	Second version

Raw schema

{
  "type": "object",
  "properties": {
    "a": {
      "type": "string",
      "description": "First version"
    },
    "b": {
      "type": "string",
      "description": "Second version"
    }
  },
  "required": [
    "a",
    "b"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

jwt_decode

Decode a JSON Web Token's header and payload without verifying the signature, and report issued-at, not-before and expiry as dates and whether it has expired. The token is not stored. Do not use the result to trust a token. Use to debug auth flows. Example: token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjMiLCJleHAiOjE3OTIyODE2MDB9.sig. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

token

string

required

The JWT

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "The JWT"
    }
  },
  "required": [
    "token"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

markdown_to_html

Convert Markdown (headings, paragraphs, bold, italic, strikethrough, links, images, inline and fenced code, lists, quotes, rules) to HTML. Raw HTML in the input is escaped, so the output is safe to embed. Use to publish agent-written Markdown on a web page. Example: markdown=# Title Some **bold** text and a [link](https://example.com).. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

markdown

string

required

The Markdown

Raw schema

{
  "type": "object",
  "properties": {
    "markdown": {
      "type": "string",
      "description": "The Markdown"
    }
  },
  "required": [
    "markdown"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

html_to_text

Strip HTML to readable plain text: scripts and styles removed, block elements become line breaks, list items get bullets, entities decoded. Use to feed web content or emails to an LLM. Example: html=<h1>Hi</h1><p>A & B</p><ul><li>one</li></ul>. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

html

string

required

The HTML

Raw schema

{
  "type": "object",
  "properties": {
    "html": {
      "type": "string",
      "description": "The HTML"
    }
  },
  "required": [
    "html"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

http_status

Name and plain-language meaning of an HTTP status code (1xx-5xx, including 402 Payment Required and 429 Too Many Requests), and whether to retry. Use when handling API errors. Example: code=429. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

code

integer

required

Status code

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Status code"
    }
  },
  "required": [
    "code"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mime

MIME (content) type for a file name or extension, e.g. report.pdf → application/pdf, and whether browsers usually display it inline. Use when uploading or serving files. Example: file=report.xlsx. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

file

string

required

File name or extension

Raw schema

{
  "type": "object",
  "properties": {
    "file": {
      "type": "string",
      "description": "File name or extension"
    }
  },
  "required": [
    "file"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

coin

Flip one or more fair coins using a cryptographic random source. Returns each result and the totals. Use for fair decisions and games. Example: count=1. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

count

integer

optional

How many coins (1-100, default 1)

Raw schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many coins (1-100, default 1)"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

dice

Roll dice in standard notation such as 2d6+3 or 1d20, up to 100 dice of up to 1000 sides, with a cryptographic random source. Returns every roll, the modifier and the total. Use for tabletop games and simulations. Example: roll=2d6+3. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

roll

string

optional

Dice notation, e.g. 2d6+3 (default 1d6)

Raw schema

{
  "type": "object",
  "properties": {
    "roll": {
      "type": "string",
      "description": "Dice notation, e.g. 2d6+3 (default 1d6)"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

random_number

One or more random whole numbers in a range (inclusive), optionally all different, from a cryptographic random source. Use for draws, sampling and games. Example: min=1, max=100, count=3, unique=true. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters4

min	integer	optional	Lowest value (default 1)
max	integer	optional	Highest value (default 100)
count	integer	optional	How many (1-1000, default 1)
unique	string	optional	true for no repeats

Raw schema

{
  "type": "object",
  "properties": {
    "min": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Lowest value (default 1)"
    },
    "max": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Highest value (default 100)"
    },
    "count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many (1-1000, default 1)"
    },
    "unique": {
      "type": "string",
      "description": "true for no repeats"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

random_pick

Pick one or more items at random (without repeats) from a comma- or line-separated list. Use for raffles, choosing who goes first, or breaking ties fairly. Example: items=Ada,Alan,Grace,Linus, count=1. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

items	string	required	Comma-separated items
count	integer	optional	How many to pick (default 1)

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "string",
      "description": "Comma-separated items"
    },
    "count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many to pick (default 1)"
    }
  },
  "required": [
    "items"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

random_shuffle

Shuffle a comma- or line-separated list into a random order (Fisher-Yates with a cryptographic random source). Use for draw orders, seating and playlists. Example: items=1,2,3,4,5. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

items

string

required

Comma-separated items

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "string",
      "description": "Comma-separated items"
    }
  },
  "required": [
    "items"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

random_teams

Split a list of names into a given number of random, evenly sized teams. Use for games, workshops and classrooms. Example: items=Ada,Alan,Grace,Linus,Margaret,Tim, teams=2. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

items	string	required	Comma-separated names
teams	integer	optional	Number of teams (default 2)

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "string",
      "description": "Comma-separated names"
    },
    "teams": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Number of teams (default 2)"
    }
  },
  "required": [
    "items"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

magic_8_ball

Ask a yes-or-no question and get one of the 20 classic Magic 8-Ball answers, chosen at random. For fun only. Use for games and chat bots. Example: question=Will it ship today?. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

question

string

optional

Your question (optional, not stored)

Raw schema

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "Your question (optional, not stored)"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

random_password

Generate strong random passwords or passphrase-style strings: choose length and character sets, from a cryptographic random source. Generated on demand; nothing is stored or logged. Use when creating accounts or secrets. Example: length=20, symbols=true, count=1. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters3

length	integer	optional	8-128 characters (default 20)
symbols	string	optional	false to leave out symbols
count	integer	optional	How many (1-20, default 1)

Raw schema

{
  "type": "object",
  "properties": {
    "length": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "8-128 characters (default 20)"
    },
    "symbols": {
      "type": "string",
      "description": "false to leave out symbols"
    },
    "count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many (1-20, default 1)"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

random_color

One or more random colours in hex, RGB and HSL, optionally limited to pastel or dark tones. Use for placeholders, avatars and design ideas. Example: count=3, tone=pastel. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters2

count	integer	optional	How many (1-50, default 1)
tone	string	optional	any (default), pastel or dark

Raw schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many (1-50, default 1)"
    },
    "tone": {
      "type": "string",
      "description": "any (default), pastel or dark"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

yes_no

A fair random yes or no, with a cryptographic random source. For quick decisions when the options are equally good. Use to break ties. Example: only=. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

only

string

optional

Optional: comma-separated top-level result keys to keep, for a smaller answer (for example only=fastestFee,halfHourFee); unknown keys are ignored and an empty match returns the full result

Raw schema

{
  "type": "object",
  "properties": {
    "only": {
      "type": "string",
      "description": "Optional: comma-separated top-level result keys to keep, for a smaller answer (for example only=fastestFee,halfHourFee); unknown keys are ignored and an empty match returns the full result"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

echo

Returns the message you send, with its length and the server time. Use to test an x402 client, payment flow or agent tool wiring end to end. Example: message=hello. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

message

string

required

Message, up to 2,000 characters

Raw schema

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Message, up to 2,000 characters"
    }
  },
  "required": [
    "message"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ping

A paid round-trip check: returns pong and the server time. Use to test that an x402 wallet, client or MCP setup can pay and receive a result. Example: only=. Price $0.003/call via x402 USDC or a card key (/credits), first 25 free; failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.

Parameters1

only

string

optional

Optional: comma-separated top-level result keys to keep, for a smaller answer (for example only=fastestFee,halfHourFee); unknown keys are ignored and an empty match returns the full result

Raw schema

{
  "type": "object",
  "properties": {
    "only": {
      "type": "string",
      "description": "Optional: comma-separated top-level result keys to keep, for a smaller answer (for example only=fastestFee,halfHourFee); unknown keys are ignored and an empty match returns the full result"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md26 KBView on GitHub

Agent Data Tools

175 pay-per-call tools for AI agents over MCP and plain HTTP: blockchain reads on 5 EVM chains plus Bitcoin, token prices and risk, OFAC sanctions and counterparty checks, company and domain data, web pages and PDFs as text, weather, time, countries, and everyday utilities (JSON, CSV, hashes, dates, validators). Most tools cost $0.003 per successful call.

Quick start

Connect any MCP client to https://agent-data-tools.revmesh2074.workers.dev/mcp (Streamable HTTP, no sign-up). Smaller sections: /mcp/prices, /mcp/chain, /mcp/web, /mcp/compliance, /mcp/ai, /mcp/everyday, /mcp/utilities.
Try free: every caller gets 25 free successful calls; over MCP they are used automatically. Over HTTP add trial=1. Failed calls never count. AI, rendering and search tools are not included.
Then pay either way:
- Card: buy prepaid credits at /credits ($5 = 5,000 credits, $20 = 22,000, $100 = 125,000; 1 credit = $0.001) and send the key as Authorization: Bearer adt_… (or X-API-Key) on HTTP calls or in your MCP client's connection headers.
- Crypto: any x402 client pays per call in USDC on Base, Polygon, Arbitrum, Monad or World Chain.

Failed calls are never charged. Free previews of every tool's output: add sample=1. Machine-readable catalog: /openapi.json, /llms.txt. Support: spellz111122@gmail.com.

Details and buyer clients

Operated by SpellzCode. Check a Base transaction or wallet through a capped, account-free client: one transaction-status result costs $0.003, a wallet snapshot $0.005. Inspect a free quote before an explicitly authorized purchase. Optional gas and allowance checks cost $0.002 each; the client never buys them automatically. Uses an existing funded Base x402 wallet and never sends the transaction being checked.

For static documentation reading, get clean text, Markdown, code and tables for $0.002 USDC on Base. No account or subscription. Static HTML, Markdown and plain text only; no JavaScript rendering, authenticated pages or paywall access.

The reader client requires Node 20.19+ and no npm installation or TypeScript. An unsigned quote needs no key and never pays. An explicit authorized reader purchase needs an existing funded Base wallet and a per-call cap of at most $0.002. The local MCP adapter starts in quotes-only mode; deliberately enabled buying shares a process budget across reader, sitemap and Bitcoin-data calls. Keys stay on the buyer's device. The separate chain client has the operation-specific caps above and grants no session or monthly spending allowance.

Repository fallback downloads for 1.7.6: CLI executable and its checksum, or local MCP adapter and its checksum. Save the executable and matching checksum in one folder, then follow the verification instructions before running it. Release notes and all six files. These match the website's published bytes; checksums are not independent security signatures. Older 1.7.0 downloads and 1.5.1 downloads remain available unchanged.

Need help with an existing attempt? Report a purchase problem using the request ID, approximate UTC time and reported payment status. Stop after an uncertain signed outcome; do not make a new purchase to reproduce it. For missing text, code or tables, report an output problem with a short public or authored example. Reports are public: never include keys, signatures, raw payment headers or private content.

The reader also supports an exact HTML section ID and retains labelled source image descriptions; it does not interpret image pixels. Source-declared authors and publication/update dates now include provenance and unverified/ambiguity warnings when available. Check scope, output limits and warnings before claiming coverage. Full buying instructions.

Cached examples are actual build-time results on owned HTML and are labelled separately from illustrative snippets. Local tests do not establish funded production delivery or customer demand.

A Cloudflare Worker that sells 175 active tools to AI agents. Each call is paid in USDC through the x402 protocol (Base, Polygon, Arbitrum, Monad or World Chain) or with prepaid card credits, and the money goes straight to the address in PAY_TO.

Endpoint	Returns	Price
`GET /sitemap?url=&contains=&maxUrls=&offset=`	XML sitemap URLs, source-reported dates and pagination (bounded, no crawling)	$0.002
`GET /extract?url=`	Web page as clean text, headings and links	$0.002
`GET /domain?name=`	DNS, registration age, SPF/DMARC	$0.005
`GET /domain-report?name=`	Domain trust verdict and email-auth flags	$0.01
`GET /token?address=`	Base ERC-20 facts and risk flags	$0.01
`GET /token-report?address=`	Base token risks and live DEX market data	$0.02
`GET /wallet?address=`	Base wallet balances and account nonce	$0.005
`GET /summarize?url=`	Short summary and key points of a page	$0.01
`GET /screenshot?url=`	JPEG of the rendered page (base64)	$0.02
`GET /image?prompt=`	Generated 1024x1024 image (base64)	$0.02
`GET /transcribe?url=`	Text of an audio file (max 5 MB)	$0.02
`GET /describe?url=`	Description of an image, or an answer about it	$0.01
`GET /btc-fees`	Bitcoin fee rates and mempool status	$0.002
`GET /btc-address?address=`	Bitcoin address balance and activity	$0.003
`GET /ln-invoice?invoice=`	Decoded Lightning invoice
`GET /package-audit?packages=`	Audit up to 10 dependencies; supports exact-version advisories and fixes	$0.20
`GET /wallet-audit?address=`	Base token holdings and nonce-based heuristic risk indicators	$0.02
`GET /contract-risk?address=`	Limited bytecode, EIP-1967 slot and zero-supply heuristics	$0.02
`GET /trade-insight?token=&wallet=`	Separate token and wallet risk indicators; no trade recommendation	$0.05
`GET /liquidity-pool-audit?address=`	Verified Base DEX pair details and reported market data	$0.03
`GET /mev-simulator`	Base gas-cost estimates using fixed typical gas units; not a quote	$0.04
`GET /package?ecosystem=&name=&version=`	Latest or pinned package metadata and bounded dependency-risk signals (not a safety guarantee)
`GET /email?address=`	Email validation without sending mail
`GET /papers?query=`	Academic paper search	$0.003
`GET /fx?from=&to=`	Currency exchange rates and conversion
`GET /btc-price`	Bitcoin price in major currencies
`GET /base-gas`	Base network gas price and fee estimate	$0.002
`GET /base-tx?hash=`	Base transaction status and details	$0.003
`GET /base-allowance?token=&owner=&spender=`	ERC-20 approval check on Base	$0.002
`GET /ens?name=`	ENS name/address resolution
`GET /weather?lat=&lon=`	Current weather and hourly forecast
`GET /time?zone=`	Current time and time zone conversion

Free calls are on: 25 successful calls per caller and 2,000 a day in total (src/lib/free-calls.ts), automatic over MCP and with trial=1 over HTTP. Without trial=1, an unpaid HTTP request gets the normal 402 challenge. The table above lists a few core tools; the full, current catalog is at /#tools and in /openapi.json.

The homepage and llms.txt include a copy-pastable Node.js/TypeScript x402 client using @x402/fetch, @x402/evm and viem. It reads the private key from X402_PRIVATE_KEY (never hard-code or commit it), pins Base, the service's published PAY_TO recipient and Base USDC, and caps each payment at $0.003, the ordinary per-call price, so it can pay for every tool priced at $0.003 or less. It does not add trial=1. /package-audit remains $0.20 per call and is intentionally refused by this lower-spend example. The OpenAPI x-guidance carries the same client, price and trial notes. Tool-specific guides (/guides/web-reading, /guides/bitcoin-fees, /guides/dependency-audit) pin that one tool's exact price instead.

A staging copy of the service runs on the Base Sepolia testnet (wrangler.staging.jsonc, keyless facilitator, faucet USDC) so every release can be paid for real over HTTP v2, HTTP v1 and MCP with scripts/pay-test.mjs before production deploys; see CLAUDE.md. Testnet settlements are never income.

/package keeps its latest-version behavior when version is omitted. Pass ecosystem, name and an optional exact version as separate inputs (for example, ecosystem=npm&name=lodash&version=4.17.20) to return pinned-version metadata and deps.dev advisories. Version ranges and tags are rejected. For exact-version OSV affected ranges and dated FIRST EPSS CVE estimates, use /package-audit.

/package-audit accepts up to 10 comma-separated ecosystem:name items, optionally with an exact version, such as npm:lodash@4.17.20 or npm:@types/node@22.0.0. Unversioned items retain latest-version checks. To bound outbound fetches, it does not query npm weekly downloads; weeklyDownloadsStatus is not-fetched-subrequest-budget. Unversioned items fetch at most one deps.dev advisory detail and report advisoryDetailsOmitted; failed detail fetches are counted in advisoryDetailsUnavailable and make advisoryDetailsStatus partial. Pinned items skip duplicate deps.dev details but retain all advisory IDs/counts. Exact versions use OSV batch IDs and up to 15 detailed records per request; per-advisory detailStatus, detailsNotFetched and omittedAdvisories identify incomplete coverage. Returned CVE aliases are enriched with dated FIRST EPSS estimates in one deduplicated request (up to 50 CVEs); epssLookup reports source status, retrieval time, omitted CVEs and uninspected OSV details. EPSS estimates 30-day exploitation probability, not package safety; missing scores are unknown, not zero. Neither ok nor an empty advisory result means a package is safe.

/airdrop-scanner, /liquidity-return-analyzer, /token-holder-analysis, /pair-analyzer and /wallet-history are deferred because this service has no verified live data sources for their advertised analyses. They are not listed as paid tools and return HTTP 503 without a payment challenge or charge.

The AI endpoints use Workers AI and /screenshot uses Browser Rendering. Account allowances and actual operating costs must be checked separately; they are not established by the API price. Upstream capacity or rate-limit failures return errors without settling a charge.

Free routes include the owned /examples/extract/ results, versioned /clients/reader/ downloads, /sitemap.xml, / (a web page for browsers, JSON for programs), /openapi.json, /llms.txt, /robots.txt, /health, /.well-known/x402, /.well-known/mcp/server-card.json, /.well-known/api-catalog.

/metrics reports daily request counts by path. unsettled counts successful HTTP 2xx responses on paid paths without a verified successful PAYMENT-RESPONSE; only calls with a valid settlement response increment paid. revenueUsdMicros is gross USD in millionths of a dollar, and trackedPaidCalls counts settled x402 HTTP API, MCP tool and /buy/<slug> calls included in that total. MCP totals are recorded only when the payment wrapper returns a successful structured settlement result; x402 product purchases use the exact product catalog price. Revenue fields are prospective and have no historical backfill. paid counts from before settlement validation are not proof of payment and must not be used as revenue. Challenges, trials, marketplace requests, unsettled responses, and direct storefront-transfer amounts are excluded.

Store

New digital-product sales are paused at /store and /buy/* (HTTP 503, no payment challenge). Existing orders and downloads are preserved. The retained implementation works as follows: A buyer gets an exact USDC amount and the address in PAY_TO; the order page watches the chain and unlocks the download when a matching transfer arrives. Agents can buy the same products at GET /buy/<slug> through the normal paywall.

Products are listed in src/store/catalog.ts.
Orders and the sales log live in the TRIALS key-value store (order: and paid: keys). List sales with npx wrangler kv key list --binding TRIALS --prefix paid: --remote.
The DeFi Trader Intelligence Bundle is delisted because the service has no API-key authentication, 250-call quota or /account endpoint. Legacy order receipts remain supported, but actual download fulfillment is unverified. Product assets under the gitignored public/_files/ directory are intentionally absent from Git and must be privately provisioned before deploying a fresh checkout; missing assets make paid downloads return 502. The existing production worktree retains these assets. Never publish them in source control.

MCP

The same 32 catalog tools are available as an MCP server at /mcp (streamable HTTP, stateless). Listing tools is free. Calling a tool without payment returns an x402 payment requirement; an MCP client with x402 support pays and retries. A tool call that fails is not charged.

Each tool is defined once in src/endpoints.ts (name, price, parameters) and implemented once in src/tools.ts; the HTTP route, MCP tool, OpenAPI document and web page are generated from that catalog.

Where it is listed

Official MCP Registry: listed as io.github.Nutshell2000/agent-data-tools. To publish a new version, raise version in server.json and push a matching v* tag; the workflow in .github/workflows/publish-mcp.yml does the rest on GitHub's servers.
402 Index (https://402index.io): existing reader entries and catalog metadata were refreshed on 15 October 2026. Third-party caches can remain stale; the live catalog and quotes take precedence.
x402scan: existing listings cover the catalog. Reconcile current prices after each release; no new duplicate registration is needed.
Coinbase Bazaar: Bitcoin fees and package metadata have indexed entries. Other routes require a genuine settled payment; a readiness pass alone does not index them.

An unpaid request gets HTTP 402 with a PAYMENT-REQUIRED header (x402) and WWW-Authenticate: Payment challenges (MPP: evm with USDC on Base, tempo with USDC.e on Tempo; settled only after the tool succeeded). Calls that fail (4xx/5xx) are not charged.

OpenAI-compatible: POST /v1/chat/completions, POST /v1/responses and POST /v1/embeddings are fronts for the paid /ai/chat, /ai/chat-large and /ai/embed tools (same prices, same payment paths); GET /v1/models is free. Point an OpenAI SDK at /v1 with an x402 or MPP fetch wrapper, or use a card-credit key as its apiKey.

Current revenue operations

New seller-kit sales are paused; existing paid orders keep download access. Free calls are on (see above) and are not revenue. /metrics reports request counters; /revenue reports deduplicated, facilitator-reported settlements observed since the ledger was deployed. Its amounts are integer native Base USDC atomic units (6 decimals), and known self-payments are excluded from gross. Receipts preserve transaction, payer, authorization nonce, endpoint and amount evidence privately in the existing Durable Object. Signatures and request content are not stored. Public responses expose aggregate totals only. A storage error is logged without turning an already-settled customer response into another payment request.

These totals remain pending independent chain reconciliation. Fees, expenses and net income are not inferred. Historical paid counters cannot be backfilled using today's prices. The two indexed historical receipts were 2,000 atomic units each and remain separate from the current settlement ledger. Tests and self-payments are never customer income.

The live catalog is authoritative for current tools, prices and trial availability.

Configuration

All settings are in wrangler.jsonc:

PAY_TO: the address that receives payments.
NETWORK: eip155:8453 for Base mainnet.
FACILITATOR_URL: the service that verifies and broadcasts payments.
PAYWALL: set to off only for local testing.
TRIALS_ENABLED: trials are disabled unless set exactly to on; set to off (or unset it) to disable them.

Commands

bash

npx wrangler dev

Read the current Worker version with npx wrangler deployments list, then deploy from a clean checkout containing current origin/main and successful CI for its exact commit:

npm run deploy:production -- --expected-version <live-worker-version-uuid>

Add --check-only for preflight without deployment. A stale checkout replaced the buying guides and ledger on 17 October; the guard rejects stale or uncommitted source and an unexpected production baseline. It cannot lock out another operator bypassing this process. Coordinate production deployments; preserve concurrent work in other checkouts.

bash

npx wrangler tail

wrangler tail streams live requests, which is the quickest way to see whether anyone is calling the service.

On Windows, wrangler dev can fail with SQLITE_CANTOPEN when the project path is long. Add --persist-to with a short folder path to fix it.

To try /screenshot without the paywall, use npx wrangler dev --remote --var PAYWALL:off. It runs on Cloudflare, so no browser is downloaded to this PC.

Listing in the Coinbase Bazaar

This deployment already uses the authenticated Coinbase CDP facilitator. For a separate installation, configure your own account:

Create a free API key at https://portal.cdp.coinbase.com.

Store it as Worker secrets (you'll be prompted for each value):

bash

npx wrangler secret put CDP_API_KEY_ID

bash

npx wrangler secret put CDP_API_KEY_SECRET

In wrangler.jsonc, set FACILITATOR_URL to https://api.cdp.coinbase.com/platform/v2/x402 and deploy.

The Bazaar indexes an endpoint after a successful settled payment with discovery metadata. Never manufacture self-purchases to seed it. npm run check:live runs the free, read-only Coinbase validator against every documented tool example. It does not sign, settle or create an index entry. The historical scripts/index-listings.mjs --pay route is disabled. HTTP and MCP funded production delivery remain separate evidence requirements.

Checking that it works

Live URL: https://agent-data-tools.revmesh2074.workers.dev

Coinbase runs a free validator. A pass shows "valid":true and "simulation":{"outcome":"accepted"}:

bash

curl -X POST https://api.cdp.coinbase.com/platform/v2/x402/validate -H "Content-Type: application/json" -d "{\"resource\":\"https://agent-data-tools.revmesh2074.workers.dev/domain?name=cloudflare.com\",\"method\":\"GET\"}"

Incoming payments show up as USDC transfers to PAY_TO on https://basescan.org.

Limits

/extract reads at most 2 MB of a page and waits at most 8 seconds for it.
/token and /wallet use the public Base RPC, which is rate limited. Set BASE_RPC_URL to a private endpoint if volume grows.
Token capability flags are bytecode heuristics, and for a proxy they describe the proxy, not its implementation.

Agent-client compatibility evidence

On 15 October 2026, @agentcash/discovery 1.7.5 discovered all 31 live routes from our OpenAPI, recognized /extract as paid x402 at 0.002 USD, retrieved the standalone-client guidance and read the full reader schema. This was a wallet-free metadata check, not funded delivery or a customer purchase. AgentCash CLI 0.17.1's check command loads an existing wallet; its discovery library can inspect schemas without one. Our standalone quote needs no wallet or key.

Reproduce the read-only check with an independently installed discovery library:

node scripts/check-agent-discovery.mjs /path/to/@agentcash/discovery/dist/index.js /private/path/evidence.json

The script does not install packages, initialize wallets, sign payments or execute paid extraction. It checks the current production catalog, price, guidance and structured output schema, plus what x402scan sees: a live 402 probe, the readable 402 body, the HTML homepage with og:image, /og.png and /status. Set CHECK_ORIGIN to check another deployment. Funded HTTP, CLI and MCP delivery require separate evidence.

Use a local MCP agent without writing a client

The bundled local MCP adapter runs with Node 20.19+ and no npm installation. Quotes-only by default. Explicit paid mode enables one-call purchases capped at $0.002 each and a process session allowance; unknown signed outcomes lock further buys. Source and setup. Preserve host tool approvals. The remote MCP connection alone does not pay automatically.

Read the relevant section of a long document

Optional section selects an exact visible heading/container ID within primary HTML. Use --section with the CLI or section with MCP. Missing/ambiguous selections fail uncharged; returned scope is explicit. Actual cached late-section example and scope instructions. Price remains $0.002. URL fragments alone do not change scope.

Portable buyer skill

The single-file reader skill gives a compatible agent the quote, authorized purchase, section-reading and failure-reconciliation workflow. Owned download and installation context. Place it in a folder named spellzcode-x402-reader in your host's configured skills location using that host's procedure. Inspect before installing; no automatic installation, wallet creation or spending authorization is supplied. Host activation and funded delivery are not established by publication.

Secondary entry: Bitcoin fee data

The same downloaded client now supports node reader-client.mjs quote-btc-fees and one authorized node reader-client.mjs buy-btc-fees --max-usdc 0.002. No URL, npm setup or Bitcoin key. Local MCP exposes btc_fees_quote/btc_fees_buy under the shared session allowance. This buys data for Base USDC and never sends Bitcoin. Setup and limitations. The static reader remains the primary workflow.

Earlier reader releases

Version 1.2.0 adds the bounded /sitemap tool and capped quote-sitemap/buy-sitemap commands. Version 1.1.2 adds a local command builder with POSIX/PowerShell quoting and a three-page research recipe, while preserving immutable 1.1.1 downloads. Reader 1.1.1 separates metadata limits from primary table text, preserves literal code whitespace and nested lists, and closes clipped code fences within the output limit. The bundled Node client supports an unsigned quote and one explicitly capped buy. Build it and the cached samples with npm run build:reader. Downloaded clients need Node 20.19+ and no project dependencies. Checksums and public source accompany the download; keys stay in the buyer's process environment.

Remote MCP advertises successful-result JSON schemas for extract, sitemap and btc-fees, matching OpenAPI. Results are checked before settlement. Quotes and failures return isError: true with JSON in content[0].text; only successful results have structuredContent. This keeps free quotes usable by schema-validating clients.

Endpoint families

MCP catalog 1.8.1 adds 113 active family tools to the 32 existing tools: blockchain reads across five networks, local data/text utilities, public-data lookups and crypto-random utilities. Active family calls cost $0.002. The live OpenAPI and catalog list the current routes. Reader downloads stay at 1.7.6 and the separate chain client stays at 1.0.0.

Four implemented family tools are paused and excluded from paid discovery: /regex/test until execution can be bounded, and /air-quality, /uv, /geocode until a source permitted for this commercial service is configured. Direct requests return uncharged 503 without calling the upstream. No subscription or new spending was added. JSON repair preserves already-valid JSON and quoted text.

Install

Tools (52)

json_validatejson_formatjson_minifyjson_repairjson_to_csvcsv_to_jsonbase64_encodebase64_decode

Remote endpoint

Streamable HTTP

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

url

https://agent-data-tools.revmesh2074.workers.dev/mcp/utilities

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agent-data-tools-utilities": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agent-data-tools.revmesh2074.workers.dev/mcp/utilities"
      ]
    }
  }
}

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

MCP Server: io.github.Nutshell2000/agent-data-tools-utilities

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

Topics

json_validate

json_format

json_minify

json_repair

json_to_csv

csv_to_json

base64_encode

base64_decode

url_encode

url_decode

url_parse

hash

hmac

uuid

slug

case

text_stats

text_extract

text_diff

cron_next

date_diff

date_add

date_info

unix

units_convert

number_words

number_roman

validate_iban

validate_isbn

validate_luhn

color

color_contrast

ip_cidr

ip_info

semver

jwt_decode

markdown_to_html

html_to_text

http_status

mime

coin

dice

random_number

random_pick

random_shuffle

random_teams

magic_8_ball

random_password

random_color

yes_no

echo

ping

Agent Data Tools

Quick start

Details and buyer clients

Store

MCP

Where it is listed

Current revenue operations

Configuration

Commands

Listing in the Coinbase Bazaar

Checking that it works

Limits

Agent-client compatibility evidence

Use a local MCP agent without writing a client

Read the relevant section of a long document

Portable buyer skill

Secondary entry: Bitcoin fee data

Earlier reader releases

Endpoint families

Install

Remote endpoint

Related servers