English Français العربية

io.github.Darkchild88/x402-money-farm

Official registry Other

Pay-per-call web extraction: clean text, metadata, links, JSON-LD, change detection. USDC on Base.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package x402-money-farm-mcp
Claude Code 
claude mcp add x402-money-farm -e 'X402_PRIVATE_KEY=<your x402_private_key>' -e 'X402_MAX_USD=<X402_MAX_USD>' -e 'FARM_BASE_URL=<FARM_BASE_URL>' -- npx -y x402-money-farm-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "x402-money-farm": {
            "command": "npx",
            "args": [
                "-y",
                "x402-money-farm-mcp@1.0.1"
            ],
            "env": {
                "X402_PRIVATE_KEY": "<your x402_private_key>",
                "X402_MAX_USD": "<X402_MAX_USD>",
                "FARM_BASE_URL": "<FARM_BASE_URL>"
            }
        }
    }
}

Environment variables

  • X402_PRIVATE_KEY secret Private 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_USD Hard spend cap in USD for the process. Default 1.00.
  • FARM_BASE_URL Service to buy from. Default https://x402-money-farm.fly.dev

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. x402 Money Farm — MCP server
  2. Add it to a client
  3. Try it before paying anything
  4. Configuration
  5. What a call costs, exactly
  6. Why pay-per-call at all
  7. License

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.

Frequently asked questions

What is io.github.Darkchild88/x402-money-farm?

Pay-per-call web extraction: clean text, metadata, links, JSON-LD, change detection. USDC on Base.

How do I install io.github.Darkchild88/x402-money-farm?

It runs on your machine. In Claude Code: claude mcp add x402-money-farm -e 'X402_PRIVATE_KEY=<your x402_private_key>' -e 'X402_MAX_USD=<X402_MAX_USD>' -e 'FARM_BASE_URL=<FARM_BASE_URL>' -- npx -y x402-money-farm-mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Darkchild88/x402-money-farm need an API key?

Yes. It expects X402_PRIVATE_KEY, which you set in its configuration.

Is io.github.Darkchild88/x402-money-farm open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Darkchild88/x402-money-farm?

It is published by Darkchild88. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.