Terradeed Mcp Server

io.github.terradeedPublished by GitHub account terradeedv0.1.4Updated Oct 24, 2026

TerraDeed MCP server — x402 web scraping & structured extraction. Pay-per-call with USDC on Base.

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinance

Overview

AI-generated overview

Connects an assistant to the Terradeed Scrape API for pay-per-call web scraping and schema-driven extraction, paid in USDC on Base.

What you can do
  • Scrape a public URL and get clean, LLM-ready markdown, optionally rendering JavaScript
  • Extract structured JSON from a page using a supplied schema and extraction instructions
  • Check the USDC balance of a wallet address on Base mainnet
When to use it
Useful when an assistant needs clean page content or structured fields from arbitrary public web pages and you are willing to pay a small per-call fee in USDC rather than run your own scraper.
Requirements
Runs locally over stdio, typically via npx or a global npm install, so Node.js is needed. Requires the TERRADEED_PRIVATE_KEY environment variable holding an Ethereum private key that has USDC on Base mainnet. Network access to the Terradeed API and Base mainnet.
Before you install
The server needs an Ethereum private key (TERRADEED_PRIVATE_KEY) that signs real USDC payments on Base mainnet; anyone with that key controls the funds, so a dedicated low-balance wallet is advisable. Calls spend money: $0.01 USDC per scrape and $0.05 USDC per structured extraction. Scraped URLs and extraction schemas are sent to the Terradeed API.

Installation

In SourceWeft

  1. Open Terradeed Mcp Server 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

Terradeed MCP Server

x402-powered web scraping and structured data extraction for AI agents.

Overview

This MCP server connects your AI agent to the Terradeed Scrape API, enabling:

  • Web scraping — Clean, LLM-ready markdown from any URL ($0.01 USDC)
  • Structured extraction — Schema-driven JSON data from any page ($0.05 USDC)
  • Wallet balance checks — Free USDC balance lookups on Base mainnet

Payments are handled transparently via the x402 protocol on Base mainnet using USDC.

Installation

Via npx (recommended)

bash
TERRADEED_PRIVATE_KEY=0x... npx terradeed-mcp-server

Global install

bash
npm install -g terradeed-mcp-serverTERRADEED_PRIVATE_KEY=0x... terradeed-mcp-server

Environment Variables

VariableRequiredDescription
TERRADEED_PRIVATE_KEYYesEthereum private key for signing x402 payments. Must hold USDC on Base mainnet.

Tools

terradeed_scrape_url

Scrape any public URL and return clean markdown.

Cost: $0.01 USDC per call

json
{  "url": "https://example.com",  "render_js": false}

terradeed_extract_structured

Extract structured JSON data using a schema.

Cost: $0.05 USDC per call

json
{  "url": "https://example.com",  "schema": {    "type": "object",    "properties": {      "title": { "type": "string" },      "price": { "type": "number" }    }  },  "instructions": "Extract the product title and price"}

terradeed_check_wallet

Check USDC balance on Base mainnet. Free.

json
{  "address": "0x..."}

Configuration

Add to your MCP client config (e.g., Claude Desktop, Cursor):

json
{  "mcpServers": {    "terradeed": {      "command": "npx",      "args": ["terradeed-mcp-server"],      "env": {        "TERRADEED_PRIVATE_KEY": "your-private-key"      }    }  }}

Links

License

MIT

Source: README.md at commit 435b78e

Tools

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

Version history

1
  1. v0.1.4LatestSep 16, 2026

Score

40% 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

    Declare a license in the repository or the registry entry.