X402 Money Farm

io.github.Darkchild88Published by GitHub account Darkchild88v1.0.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinance

Overview

AI-generated overview

Local MCP server that gives an assistant pay-per-call web extraction tools — clean text, metadata, links, JSON-LD and change fingerprints — billed in USDC on…

What you can do
  • Extract main article text from a page, as plain text or Markdown, without navigation or ads
  • Read page metadata: title, description, canonical, OpenGraph, Twitter cards, icons and dates
  • List all links on a page, absolutised and deduplicated, with internal/external and per-host counts
  • Parse JSON-LD blocks and index them by schema.org type
  • Fingerprint a page and get a changed/unchanged verdict for change detection
  • Show the free catalogue with live prices, wallet status and session spend
When to use it
Useful when an assistant needs clean page content, structured metadata or link inventories from specific URLs and you would rather pay a few cents per call than sign up for a scraping API. Also suited to monitoring pages for changes without an account or subscription.
Requirements
Runs locally over stdio via npx (Node.js). Paid tools need X402_PRIVATE_KEY, the private key of a Base wallet funded with USDC; gas is covered by the facilitator, so no ETH is needed. X402_MAX_USD sets the spend cap (default 1.00), FARM_BASE_URL sets the service endpoint, and X402_NETWORK defaults to Base mainnet. Network access is required.
Before you install
The server holds a wallet private key in a config file on disk and signs real USDC payments from it, so use a small dedicated wallet rather than a main one. Every paid call spends money; the X402_MAX_USD cap limits a looping agent but should be set deliberately. Calls send the target URLs to the remote extraction service. A failed call is not billed, and each response includes a payment block for reconciliation.

Installation

In SourceWeft

  1. Open X402 Money Farm in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

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:

bash
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

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

Source: README.md at commit 316600a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 21, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts