About x402-money-farm
x402-money-farm is a stdio MCP server for agents that need structured information from web pages. It offers text, metadata, links, JSON-LD, and change-detection tools, charging per successful request in USDC on Base without requiring an account or API key.
Key features
- 01Extract clean text as text or Markdown
- 02Retrieve page metadata and dates
- 03Collect and classify page links
- 04Parse JSON-LD by schema type
- 05Detect page changes with fingerprints
- 06View live prices and wallet status
Use cases
- 01Extract article text without page boilerplate
- 02Collect links from a set of pages
- 03Inspect structured data on a website
- 04Check whether a page has changed
MCP support
The server exposes web-extraction tools over stdio to MCP clients. Calls are paid individually in USDC on Base; `farm_catalog` is free, and a configured wallet and spend cap control paid calls.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y x402-money-farm-mcpX402_PRIVATE_KEYSecretPrivate key of a Base wallet funded with USDC, used to pay per call. Without it only the free catalogue tool works. Gas is paid by the facilitator, so no ETH is needed.X402_MAX_USDHard spend cap in USD for the process. Default 1.00.FARM_BASE_URLService to buy from. Default https://x402-money-farm.fly.devLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
6Saved tool list · updated 2w ago
This tool takes no parameters.
Details
From the project READMEx402 Money Farm — MCP server
Paid web-extraction tools for agents. No account, no API key, no subscription, no signup form: each call settles a fraction of a cent in USDC on Base, per request, and the response arrives only after settlement.
| Tool | What it returns | Price |
|---|---|---|
farm_catalog | Everything below, with live prices and wallet status | free |
farm_clean_text | Main article text without nav/ads/boilerplate, text or Markdown | $0.02 |
farm_metadata | Title, description, canonical, OpenGraph, Twitter, icons, dates | $0.01 |
farm_links | All links, absolutised, deduplicated, internal/external, per-host counts | $0.01 |
farm_jsonld | JSON-LD blocks parsed and indexed by schema.org type | $0.01 |
farm_fingerprint | Noise-normalised page fingerprint plus a changed/unchanged verdict | $0.015 |
Add it to a client
Claude Desktop — claude_desktop_config.json:
{
"mcpServers": {
"x402-money-farm": {
"command": "npx",
"args": ["-y", "x402-money-farm-mcp"],
"env": {
"X402_PRIVATE_KEY": "0xyour_funded_base_wallet_key",
"X402_MAX_USD": "1.00"
}
}
}
}
Claude Code:
claude mcp add x402-money-farm \
--env X402_PRIVATE_KEY=0x... \
--env X402_MAX_USD=1.00 \
-- npx -y x402-money-farm-mcp
Any other MCP client works the same way — it is a plain stdio server.
Try it before paying anything
npx -y x402-money-farm-mcp
Then have the agent call farm_catalog. It reports the live prices, whether a
wallet is configured and how much has been spent this session. Nothing is
billed, and no wallet is needed to see it. If the prices do not suit you, you
learned that for free.
Configuration
The server pays from your wallet, one call at a time. Gas is paid by the facilitator, so the wallet needs USDC on Base but no ETH.
| Variable | Default | Meaning |
|---|---|---|
X402_PRIVATE_KEY | — | Your funded Base wallet, 0x + 64 hex characters. Without it the paid tools decline with an explanation and only farm_catalog works. |
X402_MAX_USD | 1.00 | Hard spend cap for the process. Once reached, every further paid call is refused. |
FARM_BASE_URL | https://x402-money-farm.fly.dev | The service to buy from. |
X402_NETWORK | eip155:8453 | Base mainnet. |
Fund a wallet for this purpose with a few dollars — not your main one. The key sits in a config file on disk; treat it accordingly. The spend cap exists so a looping agent cannot drain even that wallet.
What a call costs, exactly
The price in the table is the whole price. No monthly minimum, no per-seat fee,
no metered surprise. The server returns HTTP 402 with the exact amount, your
wallet signs that amount, and you get the answer after settlement. A failed
call is not billed. Every response carries a _payment block with the amount,
the running session total and the paying address, so you can reconcile against
the chain yourself.
Why pay-per-call at all
Because the alternative is a signup, a credit card, a minimum plan and a key to rotate — for an agent that wanted the metadata of four URLs. Here the agent decides on its own, pays four cents, and nobody had to create an account.
License
MIT.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.