mcpField
X
x402-money-farm

x402-money-farm

Local
github.com/Darkchild88Browser Automation0Updated 5w ago

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

  1. 01Extract clean text as text or Markdown
  2. 02Retrieve page metadata and dates
  3. 03Collect and classify page links
  4. 04Parse JSON-LD by schema type
  5. 05Detect page changes with fingerprints
  6. 06View live prices and wallet status

Use cases

  1. 01Extract article text without page boilerplate
  2. 02Collect links from a set of pages
  3. 03Inspect structured data on a website
  4. 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.

mcp.json · Universal config
{
"mcpServers": {
"darkchild88-x402-money-farm": {
"command": "npx",
"args": [
"-y",
"x402-money-farm-mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
"X402_MAX_USD": "<X402_MAX_USD>",
"FARM_BASE_URL": "<FARM_BASE_URL>"
}
}
}
}
Run commandnpx -y x402-money-farm-mcp
Environment variables to set
X402_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.dev

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmx402-money-farm-mcp1.0.1

Tools

6

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

x402 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.

ToolWhat it returnsPrice
farm_catalogEverything below, with live prices and wallet statusfree
farm_clean_textMain article text without nav/ads/boilerplate, text or Markdown$0.02
farm_metadataTitle, description, canonical, OpenGraph, Twitter, icons, dates$0.01
farm_linksAll links, absolutised, deduplicated, internal/external, per-host counts$0.01
farm_jsonldJSON-LD blocks parsed and indexed by schema.org type$0.01
farm_fingerprintNoise-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.

VariableDefaultMeaning
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_USD1.00Hard spend cap for the process. Once reached, every further paid call is refused.
FARM_BASE_URLhttps://x402-money-farm.fly.devThe service to buy from.
X402_NETWORKeip155:8453Base 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

Markdown supported

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.