Developer Utilities & Validators (Tanod)
概览
作者提供的说明(英文原文)
Cloud GPU prices per hour, plus developer helpers: hash, HMAC, JWT, IDs, JSON, cron, time zones.
PopNx MCP 的三大支柱
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
- 用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
- 我们的基础检查i4 项中通过 4 项依据公开信息检查;尚未扫描代码
- 使用情况i起步阶段★ 1
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 在云端运行
- 传输方式: Streamable HTTP
- 分类: 开发者工具
安装
选择你使用的 AI 应用,然后复制设置。
安装之前
- 基础检查:4 项中通过 4 项
- 在作者的服务器上运行:你向它提出的内容会经过他们的服务器。
- 可以做 40 件事(工具) text_encode, hash_text, hmac_sign_verify, generate_ids …
- 注册中心没有列出需要填写的密钥。
你需要
- 在云端运行无需安装任何东西,通过互联网连接
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
适用于网页版、桌面版和手机版 Claude:
- 打开 Settings → Connectors
- 点击 Add custom connector
- 粘贴下面的地址,然后点击 Add
- 如果要求登录,请登录作者的服务
https://tanod.dev/mcp/util在终端中运行这条命令
claude mcp add --transport http util https://tanod.dev/mcp/util或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"util": {
"url": "https://tanod.dev/mcp/util"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"util": {
"type": "http",
"url": "https://tanod.dev/mcp/util"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
ChatGPT 只能连接互联网上的服务器:
- 打开网页版 ChatGPT → Settings → Connectors (Apps)
- 点击 Create 或 Add(部分套餐需要先在 Advanced 中开启 Developer mode)
- 粘贴下面的地址,起个名字,然后保存
- 如果要求登录,请登录作者的服务
https://tanod.dev/mcp/util菜单名称可能因套餐和版本不同而略有差异。
你的选择通过 Cookie 保存在这台设备上,无需账户。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
哪些应用可以使用它
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
通过互联网连接,适用于
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
它能做什么
工具名称和描述与服务器在 2026年11月9日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
text_encodeutilpeek: Encode or decode text: base64, hex, URL, punycode, JWT decode, ... For digests use hash_text; for a JWT's claims use decode_jwt. Returns the text encoded or decoded with `codec`: base64, base64url, base32, hex, url (percent), html (entities), quoted_printable, rot13, pu
hash_textutilpeek: Hash text or bytes: sha256, keccak256, blake2b, md5, crc32, ... For a keyed HMAC use hmac_sign_verify. Returns hex digests of the text (as UTF-8) or base64 bytes you send. md5 and sha1 are for checksums, not security. Send exactly one of text or base64 (else 422 invalid
hmac_sign_verifyutilpeek: Returns the HMAC of a message under a shared key (sign), or whether a signature matches it in constant time (verify); handles GitHub (`sha256=` prefix accepted), Stripe `v1` (of `{t}.{raw body}`) and Slack `v0` (of `v0:{timestamp}:{raw body}`) webhook signatures. For pl
generate_idsutilpeek: Generate UUIDs or ULIDs. For numbers, bytes and picks use generate_random. Returns 1-100 new identifiers: random UUID v4, time-ordered UUID v7 (RFC 9562) or ULIDs, optionally strictly increasing within the response (v7 and ULID; per response on purpose, so one caller ca
generate_randomutilpeek: Generate cryptographically strong random numbers, bytes, UUIDs, dice rolls, picks and shuffles. For UUIDs and ULIDs use generate_ids. Returns values from the OS CSPRNG (Python `secrets`): integers (uniform, inclusive range), floats in [min, max), 1-1,024 random bytes (h
validate_jsonutilpeek: Validate JSON against a JSON Schema. To pull JSON out of prose use extract_json_with_schema; to convert formats use convert_data. Returns whether a JSON value is valid against a JSON Schema (draft from $schema, default 2020-12; 2019-09, 7, 6, 4 and 3 recognised), with u
convert_datautilpeek: Convert data between JSON, YAML, CSV, TOML and XML. To check JSON against a schema use validate_json. Returns the document converted from json, yaml, csv, toml or xml to json, yaml, csv or toml. YAML uses libyaml's restricted loader (alias bombs refused); XML with DTDs
validate_identifierutilpeek: check the format and check digits of an identifier. For a VIN's vehicle use decode_vin; for phone numbers use parse_phone_number. Returns `valid`, `reason` (invalid_checksum, invalid_length, invalid_format, ... when not valid), `compact`, `formatted` and a kind-specific
parse_phone_numberutilpeek: parse and format a phone number. For a prefix's country and network use lookup_phone_prefix. A string that is not a phone number, or a national form without region, is a 422 (not charged). Offline numbering-plan check (phonenumbers, Apache-2.0): `valid` means the number
lookup_phone_prefixutilpeek: Look up a phone number prefix: country, line type and original network, with ambiguity. To parse a full number use parse_phone_number. Returns the country, line type, original network, time zones and E.164 form of the leading digits of a number (0917, +63917, 0063917),
parse_user_agentutilpeek: parse a User-Agent string. For known x402 monitors and indexers with call rates use identify_x402_client. A User-Agent is self-reported and easy to fake; `is_bot` is a heuristic (declared crawlers, HTTP libraries, headless browsers). Parsed with ua-parser and the uap-co
parse_urlutilpeek: parse a URL. To fetch the page use render_page. The URL is parsed, never fetched. Public-suffix split from the Public Suffix List snapshot bundled with the parser (dated 2025-04-07; suffixes added later are not known), with and without the PSL private section; credentia
cron_next_runsutilpeek: the next run times of a cron expression. For iCalendar RRULEs use expand_rrule. Standard 5-field cron (minute hour day-of-month month day-of-week) or a macro (@daily, @hourly, ...); no seconds or year fields, no R/H/W. Day-of-month and day-of-week use Vixie OR semantics
convert_timeutilpeek: convert one instant between time zones. For business days use count_or_add_business_days. Zones come from the pinned IANA tz database (tzdata package), not the host; a wall time in a DST gap or fold is flagged `nonexistent` / `ambiguous`; a time with an offset plus `fro
get_public_holidaysutilpeek: public holidays of a country for a year. To count working days use count_or_add_business_days. An unsupported country, subdivision, language or year is a 422 naming the supported values (not charged). Typically under 0.1 s. Price: USD 0.001. Free: 10 utilpeek calls per
count_or_add_business_daysutilpeek: Count business days between two dates or add working days, skipping public holidays. For the holiday list use get_public_holidays. Returns the business days between two dates (mode count; both ends included by default, like NETWORKDAYS) or the date N business days after
convert_unitsutilpeek: Convert units of measurement: length, weight, temperature, volume, pressure, energy, data size. For numbers in words use text_numbers. Returns a value converted between two units of one category, with the exact factor: length, mass, temperature (with offsets), volume (U
convert_color_check_contrastutilpeek: Convert a color between hex, RGB, HSL and OKLCH and check WCAG contrast. For contrast alone use check_wcag_contrast. Returns a CSS color (hex, rgb(), hsl() or a CSS name) as hex, rgb, hsl, hsv, naive cmyk, OKLCH and WCAG relative luminance; with a `background`, the WCAG
check_wcag_contrastutilpeek: Check the WCAG contrast between a text color and a background color. To convert colour formats too use convert_color_check_contrast. Returns the WCAG 2.x contrast ratio of a `foreground` and a `background` CSS color, with AA / AAA pass or fail for normal text, large tex
geocodeutilpeek: offline geocoding over the GeoNames cities15000 table. For places of a kind nearby use find_places_nearby. Input: either `place` alone or `lat` and `lon` together. `place` matches cities of 15,000+ people offline ("City" or "City, CC" with an ISO country code or a US st
make_qr_codeutilpeek: make a QR code image. For 1-D barcodes use make_barcode; to read a code use read_qr_barcode. Returns `svg` (text) or `data_base64` (PNG), or with `output` "url" a 24 h download link, plus `version`, `modules`, `width_px`, `height_px` and `bytes`. Data too long for a QR
make_barcodeutilpeek: make a 1-D barcode image. For QR codes use make_qr_code; to find the product behind a number use lookup_barcode_product. Returns `svg` (text, with width_mm/height_mm) or `data_base64` (PNG, with width_px/height_px; `output` "url": a 24 h link), plus `encoded` and `bytes
read_qr_barcodeimagepeek: Read every QR code and barcode in an image. To make a QR code use make_qr_code; for other text use ocr_image. Returns every code found: `type` (QR, EAN-13, EAN-8, UPC-A, UPC-E, Code128, Code39), decoded `text`, `kind` (url, wifi, vcard, payment_emv, ...), corner `point
peppol_lookuputilpeek: Check whether a company is registered on the Peppol e-invoicing network. For the legal entity use search_lei. Returns whether a Peppol participant ID (such as 0192:983887457) is registered on the Peppol e-invoicing network, from its SML DNS record; if so, its SMP URL an
lint_x402_listingutilpeek: Lint an x402 listing, or check a seller's Bazaar coverage. For price position, preflight and demand too use x402_seller_report. Returns in mode lint the listing's problems against the CDP rules, a score and a suggested description; in mode coverage each paid route of a
check_header_budgetutilpeek: Measure response headers against nginx, aiohttp, Node fetch and Python limits. Returns response-header byte sizes, total, Set-Cookie count and size, the five largest fields, and nginx/aiohttp/Node/Python pass/fail with limit overrides. One unpaid public-HTTPS GET, no re
build_ics_eventutilpeek: Build an iCalendar file from JSON events. To read an .ics file use parse_ics. Returns RFC 5545 VCALENDAR text built from 1-50 events, CRLF lines folded at 75 octets and text escaped, with its base64, a data: URI and the uids. Input: `events`, optional `calendar_name`, d
parse_icsutilpeek: Parse an iCalendar file into JSON events. To write one use build_ics_event. Returns iCalendar text (Google, Outlook, Apple, up to 1 MB) unfolded and read into events. Windows zone names are mapped; at most 2,000 events (`truncated` when more). Input: `ics`, optional `ti
expand_rruleutilpeek: Expand an iCalendar RRULE into dates. For cron use cron_next_runs; to build an event use build_ics_event. Returns an RFC 5545 RRULE and a start expanded into its occurrence list with python-dateutil in an IANA time zone: wall-clock times keep across DST changes. Up to 1
decode_jwtutilpeek: Decode a JWT without verifying it. To check the signature use verify_jwt. Returns a compact JWT split into its header and payload JSON, with alg, typ, kid, whether a signature is present, and the standard claims: iat, nbf and exp as ISO 8601 UTC, plus expired and not_ye
verify_jwtutilpeek: Verify a JWT signature and claims. To read the claims without a key use decode_jwt. Returns valid true or false for a JWT checked with PyJWT against one key (HMAC secret, PEM public key or JWK Set), with a reason: bad signature, expired, wrong audience or issuer, algori
decode_lightning_invoicechainpeek: Decode a Lightning invoice: amount, payee, payment hash and expiry. For EVM calldata use decode_calldata; for Nostr ids use decode_nostr_id. Returns a Lightning invoice's network, amount (msat, sat, BTC), creation time, expiry and expired flag, payee public key recover
decode_nostr_idchainpeek: Decode a Nostr npub, nprofile, note, nevent or naddr to hex; resolve NIP-05. For ENS names use resolve_ens. Returns a Nostr NIP-19 identifier decoded to hex (public key or event id) and its TLV fields (relays, author, kind), or a NIP-05 name@domain resolved to a public
get_gpu_pricesutilpeek: GPU prices: cheapest H100, A100, L4 per GPU-hour on AWS, Azure, Google Cloud, Akash. Returns cheapest GPU prices per GPU-hour on AWS, Azure and Google Cloud (list prices) and Akash (marketplace bids with GPUs free), by chip, memory, minimum GPUs per cloud machine, regio
get_gpu_price_indexutilpeek: GPU price index: daily H100, H200, A100 rental price per GPU-hour over time. Returns a GPU chip's daily rental price history: lowest and median on-demand list price, lowest spot, Akash median bid and free GPUs. List prices and marketplace bids, not executed trades. Days
upload_file_get_linkutilpeek: Upload a file and get a download link that expires in 24 hours. Returns a public download link to a file you upload, valid for `ttl_hours` (default 24, the most); every call stores a new copy under a new link. Over HTTP the file may also be the raw request body or a mul
find_places_nearbyutilpeek: Find places nearby: pharmacies, cafes, ATMs, shops and hospitals near a point, from OpenStreetMap. To resolve a city name use geocode. Returns places of one kind (pharmacy, cafe, supermarket, ATM, hospital, clinic, bicycle or hardware shop, fuel, EV charging and more) w
lookup_barcode_productutilpeek: Look up the product behind a barcode in open product databases, with conflicts flagged. To make a barcode use make_barcode; to read every code in an image use read_qr_barcode; to validate other identifiers use validate_identifier. Returns what a barcode is: check digit,
render_mermaidpdfpeek: Render Mermaid diagram code to an SVG or PNG image. Returns Mermaid diagram code drawn as an SVG or PNG file in an offline sandboxed browser: `format` svg | png, `theme` (default, dark, forest, neutral, base), `scale` 1-4 for PNG (default 2, sharp when zoomed). File base
search_datasetsutilpeek: Find datasets on Hugging Face Hub only. Returns public datasets from Hugging Face Hub only, ranked by downloads: link, licence and size labels, downloads and last update. Optional licence, task, language and size filters. Licence tags are as published by dataset authors
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月10日
- ✓ 通过
作者与仓库一致
注册名称已通过域名 tanod.dev 验证(注册中心会核实域名所有权)
- ✓ 通过
仍在维护
代码最后更新于今天
- … 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
- ✓ 通过
端点有响应
在 288 毫秒内响应(HTTP 200)
- – 不适用
使用 OAuth 登录
无需登录
- ✓ 通过
工具描述中没有隐藏指令
已读取 40 个工具描述,未发现针对 AI 的隐藏指令
与“开发者工具”中的其他服务器比较i
- 星标数多于此分类中其他 5729 个服务器的 65%
- 发布到注册中心的时间比此分类中其他 5729 个服务器的 94% 更新
- 基础检查结果等于或优于此分类中其他 5729 个服务器的 100%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Developer Utilities & Validators (Tanod) 安全吗?
它在 4 项适用的基础检查中通过了 4 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
它还在维护吗?
GitHub 仓库最后更新于今天,最新版本(0.1.3)于昨天进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。
有什么可以替代它?
同一分类中有:REA, Netdata, Front-End Checklist
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Netdata
Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Front-End Checklist
Review frontend code and live pages against 386 quality-gated web development rules.
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
Tanod MCP server
One hosted MCP server for AI agents, also available as focused servers: https://tanod.dev/mcp.
- Connection: stateless Streamable HTTP. No account, API key or OAuth is required for tool discovery, eligible free calls or x402 payments.
- Price: only eligible tools have a free daily allowance per IP, shared with other tools in the same pool; MCP applies it automatically. Other calls require payment. Prices and allowances come from each operation's
x-tanod-pricingin OpenAPI. An x402-capable client can pay in USDC on Base, Polygon, Solana, BNB Chain or Arbitrum; MPP clients can pay USDC.e on Tempo with the Tempo CLI, mppx or AgentCash. Check the quote and approve the cost before paying. See the Tanod SDKs, the x402 guide and the MPP guide. - Setup: https://tanod.dev/connect/. Docs for agents: https://tanod.dev/llms.txt. OpenAPI: https://tanod.dev/openapi.json.
Focused servers
Connect a focused server when you want a smaller tool list. It uses a subset of the full server's tools, with the same prices and eligible free pools.
| URL | What it does |
|---|---|
https://tanod.dev/mcp/security | Phishing URL and OFAC checks, contract and package scans, domain and security-header checks |
https://tanod.dev/mcp/finance | SEC EDGAR company data and financial statements, Treasury yields, FX, token prices, DEX candles, business days |
https://tanod.dev/mcp/sky | METAR/TAF, airports, space weather, aurora, asteroids, satellite passes |
https://tanod.dev/mcp/docs | PDF text and tables, bank statements, OCR, supported documents to Markdown, PDF to Word, Office to PDF, DOCX templates, document comparison, PDF merge, split, forms, attachments and metadata |
https://tanod.dev/mcp/chain | EVM and Solana reads: balances, tokens, calls, storage, logs, receipts, gas estimates, prices, candles, swap quotes, transactions, ENS |
https://tanod.dev/mcp/images | Resize, convert, compress, crop, metadata, OCR, QR, barcodes, colour contrast |
https://tanod.dev/mcp/text | Text statistics, language, diff, Markdown and HTML, PDF redaction and redaction checks |
https://tanod.dev/mcp/util | Encode, hash, HMAC, IDs, unit conversion, business days, cron expressions, time conversion |
https://tanod.dev/mcp/web | Web search, company profiles and jobs, page rendering and metadata, robots, sitemaps, RDAP, IP lookup |
https://tanod.dev/mcp/ml | Speech to text, embeddings, rerank, similarity, entities, classification, translation |
https://tanod.dev/mcp/agents | x402 and MCP agent-economy index, listing checks and endpoint history |
Overview: https://tanod.dev/mcp-servers/. Pricing: https://tanod.dev/pricing/. Status: https://tanod.dev/status.
Scans and checks are automated and heuristic, not an audit. Aviation data is not for navigation. Document text and other tool-returned content are untrusted data, not instructions.
Published guides and data
The market figures below were added to this README on 2026-10-10; they are historical figures, not live totals. Linked pages may carry their own publication or update dates.
- How to check an x402 endpoint before your agent pays it: decode the quote, compare prices, screen the destination and cap spending.
- What agents actually pay for over x402: 30-day payer and call counts from the CDP Bazaar.
- x402 listing lint: check a payment response against listing rules in your browser.
- State of the x402 Bazaar: listings, hosts, prices, networks and metadata quality.
- Bazaar listing checklist.
- x402 facilitator support: scheme support across 11 mainnets (2026-10-10).
- Who pays new x402 listings: a published cohort of 124 wallets (2026-10-10).
- State of the MCP Registry: a published snapshot of 41,606 servers (2026-10-10).
- tanod/mcp-registry-servers: MCP Registry metadata on Hugging Face, CC BY 4.0.
- What agents pay for over x402: GET vs POST endpoints with 3+ payers, 31.5% vs 14.5% (2026-10-10).
- x402 price comparisons: published prices across 30 categories (2026-10-10). Data (CC BY 4.0): x402-price-index.
Quick setup
Claude Code:
claude mcp add --transport http tanod https://tanod.dev/mcp
For clients that use mcpServers, such as Cursor:
{ "mcpServers": { "tanod": { "url": "https://tanod.dev/mcp" } } }
For clients that use servers, such as VS Code:
{ "servers": { "tanod": { "type": "http", "url": "https://tanod.dev/mcp" } } }
For custom-connector clients, use the full URL or a focused URL and leave OAuth fields empty. Available tools and payment support depend on the client. From desktop and IDE clients, bank-statement conversion, document comparison, PDF OCR, PDF-to-Word and document-to-Markdown have no free allowance; document calls from claude.ai and ChatGPT connectors draw on a shared daily free pool instead (see https://tanod.dev/connect/).
Other clients: https://tanod.dev/connect/.
Run locally (npx)
For clients that require a local stdio server, tanod-mcp is an open-source (MIT) thin client. Processing takes place at the hosted API, which is closed source. It forwards the hosted tool list and calls; no catalog is hard-coded. Remote-capable clients do not need this package.
Eligible free allowance applies automatically. Without a configured payment key, paid calls are not signed. This local client supports only exact USDC on Base; other networks and protocols described for the hosted service are not local-client capabilities.
Quick start
npx -y tanod-mcp
Requires Node.js 18 or newer. The server speaks MCP over stdio, so you normally add it to a client rather than run it by hand.
Claude Code
claude mcp add tanod -- npx -y tanod-mcp
With a key and caps:
claude mcp add tanod -e TANOD_PRIVATE_KEY=0x... -e TANOD_MAX_USD_PER_DAY=0.50 -- npx -y tanod-mcp
Claude Desktop
Edit claude_desktop_config.json:
{
"mcpServers": { "tanod": { "command": "npx", "args": ["-y", "tanod-mcp"] } } }
Cursor
~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": { "tanod": { "command": "npx", "args": ["-y", "tanod-mcp"] } } }
VS Code
.vscode/mcp.json:
{
"servers": { "tanod": { "type": "stdio", "command": "npx", "args": ["-y", "tanod-mcp"] } } }
To enable payments, add an "env" object to any of these, for example "env": { "TANOD_PRIVATE_KEY": "0x..." }.
Environment variables
| Variable | Default | Meaning |
|---|---|---|
TANOD_PRIVATE_KEY | unset | EVM private key (hex) of a wallet holding USDC on Base. Optional. Unset means free tier only. |
TANOD_MAX_USD_PER_CALL | 0.05 | Refuse to sign any single payment above this many US dollars. |
TANOD_MAX_USD_PER_DAY | 1.00 | Refuse to sign once the total for the current UTC day would pass this. |
TANOD_STATE_FILE | ~/.tanod-mcp/spend.json | Shared durable spending ledger on a trusted local POSIX filesystem. All processes spending the same budget must use the same path. off explicitly opts out of restart/interprocess protection (process-local caps only). |
TANOD_MCP_URL | https://tanod.dev/mcp | Upstream server. For testing only. Must be https://; plain http:// is accepted only for localhost, 127.0.0.0/8 or [::1]. Redirects are not followed. |
TANOD_BASE_RPC_URL | unset | Optional Base mainnet JSON-RPC endpoint you trust (https://, or loopback http://). Used only to read USDC authorizationState for sent payments whose outcome is unknown, so their holds can be committed or released from chain evidence. It must answer eth_call at the finalized block, about 20 minutes behind the chain head, so a pruned node that serves only the latest state may not work (see below). Redirects are not followed. Never logged. |
Full-index calls
bulk_agent_index exceeds both default caps above. Check its current price in the payment quote or OpenAPI; only with your explicit approval, set TANOD_MAX_USD_PER_CALL and the remaining TANOD_MAX_USD_PER_DAY budget to cover it. Caps are never raised automatically. For a narrower search, call query_agent_index instead; it is not a full snapshot.
Code clients using @x402/mcp also enforce the core spendControls.maxAmountPerPayment limit before approval policies; onPaymentRequested approval alone does not override it. Keep wallet keys in local client configuration, never in chat.
How payment works
- You call a tool. The server uses its free daily allowance if it has one.
- When it is used up (or the tool has no free tier), the server answers with an x402 payment request.
- Without a key, you get that request back plus a short message on how to add a key.
- With a key,
tanod-mcpchecks the price against your two caps. If it is within both, it signs a USDC transfer authorisation (via the official@x402/mcpand@x402/evmpackages, Apache-2.0) and retries the call. If not, it refuses with a clear error and signs nothing. Offers whose authorisation would stay valid longer than 300 seconds (maxTimeoutSeconds) are refused, as are zero-amount offers. Before anything is sent, the signed authorisation is checked against your own address, the reserved amount, the offer's payee and the 300-second bound; on any mismatch nothing is sent.
Payments are only ever signed for USDC on Base mainnet.
Security notes
- The key is read only from
TANOD_PRIVATE_KEY. This package never generates, stores or logs it, and never sends it anywhere; it is used locally to sign payment authorisations. - Use a dedicated wallet funded with a small amount (a few dollars). Do not reuse a wallet that holds real savings.
- The caps are your safety net. Lowering them is always safe; raise them only on purpose.
- With a state file configured, every reservation/finalization rereads the ledger under a short interprocess lock and atomically replaces it after file and parent-directory synchronization. Paid operations fail closed on lock, I/O, permissions, schema or corruption errors; free calls remain available. No best-effort reset to zero occurs. Do not delete the ledger or its
.initializedmarker to regain budget. - Amounts and limits use exact atomic USDC. Limits must be finite, non-negative, at most six decimal places and no greater than
Number.MAX_SAFE_INTEGERatomic units. A malformed/unsupported offer never reaches the signer. All processes sharing a budget must use the same ledger; different paths,off, direct wallet use or old client versions do