Use it to let an agent call eight paid, per-call utilities over MCP, paying USDC on Base from your own wallet.
geocode: address/place name → ranked coordinates with components and importance score.
reverse_geocode: coordinates → street address, or null with reason if ocean/unmapped.
weather: current conditions + up to 7-day forecast for any coordinates.
web_search: free-text query → ranked organic results, no ads, unverified.
url_to_markdown: public article/PDF URL → clean Markdown, with SSRF guard.
secure_random: CSPRNG bytes or uniform integers in an inclusive range.
sanctions_screen: screen a name against OFAC SDN/Consolidated lists with match score and risk level.
lei_lookup: find GLEIF Legal Entity Identifier by company name or exact LEI.
Tools list without a key; actual calls require EVM_PRIVATE_KEY with USDC on Base. Successful payments return settlement tx hash.
Provides web search via DuckDuckGo, returning ranked organic results (no ads) for free-text queries.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@agent-utils-mcp What's the weather in Tokyo?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Eight utilities your agent can call — geocoding, weather, web search, URL-to-Markdown, randomness and compliance lookups — paid per call in USDC on Base via x402, from your own wallet.
This package is not on npm yet. Install it straight from GitHub — this is the command that works today:
npx -y github:donnywin85/agent-utils-mcpThat starts the MCP server on stdio and it will list all eight tools with no wallet and no key. You only need a funded key to actually call one.
Add it to Claude Code — one line, and the tools are live in your next session:
claude mcp add agent-utils --env EVM_PRIVATE_KEY=0xyour_disposable_base_key -- npx -y github:donnywin85/agent-utils-mcpRelated MCP server: NEX Agent Co. MCP Server
tool | what it does | price |
| address or place name → coordinates, with ranked candidates | $0.01 |
| coordinates → street address | $0.01 |
| current conditions + up to a 7-day forecast for any coordinates | $0.01 |
| free-text query → ranked organic results (no ads) | $0.01 |
| article or PDF URL → clean Markdown | $0.01 |
| CSPRNG bytes, or uniform integers in a range | $0.01 |
| OFAC SDN / consolidated sanctions screening for a name | $0.01 |
| GLEIF Legal Entity Identifier for a company | $0.03 |
Prices live in one table in src/index.mjs; npm run pricecheck compares it
against the gateway's own /openapi.json and fails on any drift.
These figures were read from the gateway's
/openapi.jsonon 2026-09-07 andnpm run pricecheckpassed against it on the same run. You are charged the gateway's price, not this table's — re-run the check before trusting it.
The server signs each payment with a key it reads from its own env, which you set in your MCP client's config. Nothing is bundled, and no key is ever sent anywhere except as an EIP-3009 signature to the x402 facilitator.
Fund a wallet with a few dollars of USDC on Base.
It needs zero ETH — payments use transferWithAuthorization and the
facilitator broadcasts and pays the gas.
Use a low-balance, disposable wallet. The key sits in your client config in plaintext; any process that can read that file can spend from it.
Claude Desktop (claude_desktop_config.json), Cursor, or any MCP host:
{
"mcpServers": {
"agent-utils": {
"command": "npx",
"args": ["-y", "github:donnywin85/agent-utils-mcp"],
"env": {
"EVM_PRIVATE_KEY": "0xyour_disposable_base_wallet_key"
}
}
}
}Tools list fine without a key — you can inspect what is on offer before funding anything. The first paid call is where a missing key is reported, in as many words:
/geocode failed: EVM_PRIVATE_KEY is not set. Add it to this MCP server's env in
your client config.Argument names are short: geocode takes q, not query.
Every tool returns the upstream JSON plus, on a successful payment, the settlement transaction hash:
(paid $0.01 USDC — settle tx 0xb2397b96…)That is deliberate: you can verify on Basescan that you were charged once, for what you got, rather than taking the server's word for it.
The first six were not chosen by guesswork. They are the categories that USDC receipts across 1,062 x402 seller wallets showed agents actually pay for — geocoding (56 payers), weather (21), article/PDF→Markdown (7), randomness (6), web search (6).
The upstreams follow two rules worth knowing as a caller:
A missing value is null with a reason, never a plausible-looking number.
Weather reports no reading rather than zero; reverse-geocode says "ocean or
unmapped" rather than inventing an address.
The limits of an answer are stated in the answer. Forecast rows are
labelled model output; search says results are unverified and that its ranking
is DuckDuckGo's; web_search's count is a maximum, not a promise, because a
result whose destination cannot be resolved is dropped rather than guessed at.
url_to_markdown refuses private, loopback, link-local and cloud-metadata
addresses, and re-validates every redirect hop — it fetches caller-supplied URLs
from inside a private network, so that guard is not optional.
You want the same utilities for free, without a wallet — dex-data-mcp
carries geocode, reverse_geocode, get_weather, search, url_to_markdown
and get_random on a keyless free tier, alongside 16 more tools. If you do not
need this server's compliance pair, start there: claude mcp add dex-data -- npx -y dex-data-mcp.
You want cross-DEX market data — arb-dex-mcp
(keyless) or bsc-dex-spread-mcp (paid, one tool).
You want the human-approval loop these services are operated by —
approval-queue-starter, one file, zero deps.
Something is broken, or you want volume pricing — the gateway returns a
contact address on every 402, and a human reads it.
MIT.
Forward geocoding: turn an address or place name into latitude/longitude. Returns ranked candidates with display name, coordinates, bounding box, address components, and an importance score so you can judge ambiguity rather than assume the first hit is right. Data from OpenStreetMap Nominatim. Costs $0.003 USDC per call on Base mainnet (eip155:8453), paid automatically from the wallet in EVM_PRIVATE_KEY.
Inputs: q (required).
Legal Entity Identifier (LEI) lookup from the GLEIF golden copy. Search by company NAME, not just by identifier — knowing the LEI already is the hard part. Returns the LEI, registered legal name, previous names, legal form, jurisdiction, legal and headquarters addresses, and the registration record. LAPSED, RETIRED and ANNULLED entities are returned with a lapsed flag rather than hidden, because a filtered record and no record look identical to a caller. Costs $0.03 USDC per call on Base mainnet (eip155:8453), paid automatically from the wallet in EVM_PRIVATE_KEY.
Inputs: q (required), lei, limit.
Reverse geocoding: turn latitude/longitude into a street address with structured components. Returns null with a reason rather than a guess when the point is ocean or unmapped. Data from OpenStreetMap Nominatim. Costs $0.003 USDC per call on Base mainnet (eip155:8453), paid automatically from the wallet in EVM_PRIVATE_KEY.
Inputs: lat (required), lon (required).
OFAC sanctions screening. Checks a person or company against the US Treasury SDN and Consolidated lists — 19,600+ designated parties and 40,000+ names including every alias — and returns the matched record with its sanctions programs, designation remarks and a match score. Word order does not matter, because OFAC stores people as "SURNAME, Given". riskLevel is hit, possible or clear, and "clear" is scoped to the lists named in the response: EU, UK and UN are NOT screened. If the lists cannot be loaded you get an error, never a clear — a screening tool that says "no match" when it has no list is worse than one that is down. Costs $0.03 USDC per call on Base mainnet (eip155:8453), paid automatically from the wallet in EVM_PRIVATE_KEY.
Inputs: name (required), type, limit, minScore.
Cryptographically secure random values from a CSPRNG: either random bytes (hex and base64url) or uniform integers in an inclusive range. Integers are rejection-sampled, so the distribution is uniform rather than modulo-biased. For randomness nobody else could have seen, generate it yourself — this is for callers that cannot. Costs $0.003 USDC per call on Base mainnet (eip155:8453), paid automatically from the wallet in EVM_PRIVATE_KEY.
Inputs: max, min, bytes, count.
Fetch a public article or PDF URL and return clean Markdown, using Firefox reader-mode extraction for HTML and text extraction for PDFs. Returns title, byline, excerpt, word count and a truncation flag. JavaScript is not executed, so client-rendered pages return an explicit not_extractable error rather than an empty page passed off as the article. Private, loopback and cloud-metadata addresses are refused. Costs $0.003 USDC per call on Base mainnet (eip155:8453), paid automatically from the wallet in EVM_PRIVATE_KEY.
Inputs: url (required).
Weather for any coordinates worldwide: current temperature, feels-like, humidity, precipitation, wind speed, gusts and direction, plus up to a 7-day daily forecast with highs, lows, precipitation totals and probability. Every condition carries both the standard WMO code and plain text. Forecast rows are model output and the response says so. Pair with geocode to go from a place name to coordinates. Data from Open-Meteo. Costs $0.003 USDC per call on Base mainnet (eip155:8453), paid automatically from the wallet in EVM_PRIVATE_KEY.
Inputs: lat (required), lon (required), days.
Web search: a free-text query returns ranked organic results with title, real destination URL, display URL and snippet. Sponsored rows are excluded. Results are not fetched or verified — a listing says nothing about whether the page is correct or still live. Pair with url_to_markdown to read any result. Costs $0.003 USDC per call on Base mainnet (eip155:8453), paid automatically from the wallet in EVM_PRIVATE_KEY.
Inputs: q (required), count.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 8 tools
Each tool has a clearly distinct purpose: geocoding (forward and reverse), web content extraction, weather, search, random generation, sanctions screening, and LEI lookup. There is no overlap or ambiguity between any pair of tools.
All names are lowercase with underscores, but they follow different grammatical patterns: single verbs (geocode, reverse_geocode), noun phrases (weather, secure_random), object-verb compounds (web_search, sanctions_screen), and transformation descriptions (url_to_markdown). The naming is readable and descriptive but not consistently patterned.
With 8 tools, the server is well-scoped for a general-purpose utility kit. Each tool offers a useful, independent capability without excessive overlap or bloat.
The utility set covers each advertised domain reasonably well: forward and reverse geocoding, HTML/PDF extraction, current and forecast weather, web search, secure randomness, and two specialized lookups. Minor gaps exist (e.g., no pagination for web_search, no historical weather), but no critical dead ends are apparent.
Paid MCP tools behind one endpoint. Agents pay per call in USDC on Base via x402.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
5 pay-per-call SEO tools over MCP. Free discovery, tool calls settle in USDC on Base via x402.
17 pay-per-call web, finance, legal and onchain tools for AI agents. USDC on Base via x402/MPP.
