English Français العربية

io.github.terradeed/terradeed-mcp-server

Official registry Search and web

TerraDeed MCP server — x402 web scraping & structured extraction. Pay-per-call with 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 terradeed-mcp-server
Claude Code 
claude mcp add terradeed-mcp-server -e 'TERRADEED_PRIVATE_KEY=<your terradeed_private_key>' -- npx -y terradeed-mcp-server@0.1.4
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "terradeed-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "terradeed-mcp-server@0.1.4"
            ],
            "env": {
                "TERRADEED_PRIVATE_KEY": "<your terradeed_private_key>"
            }
        }
    }
}

Environment variables

  • TERRADEED_PRIVATE_KEY required secret Ethereum private key for signing x402 USDC payments on Base mainnet

Documentation

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

Contents
  1. Terradeed MCP Server
  2. Overview
  3. Installation
  4. Environment Variables
  5. Tools
  6. Configuration
  7. Links
  8. License

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

TERRADEED_PRIVATE_KEY=0x... npx terradeed-mcp-server
Global install
npm install -g terradeed-mcp-server
TERRADEED_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

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

Extract structured JSON data using a schema.

Cost: $0.05 USDC per call

{
  "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.

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

Configuration

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

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

License

MIT

Frequently asked questions

What is io.github.terradeed/terradeed-mcp-server?

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

How do I install io.github.terradeed/terradeed-mcp-server?

It runs on your machine. In Claude Code: claude mcp add terradeed-mcp-server -e 'TERRADEED_PRIVATE_KEY=<your terradeed_private_key>' -- npx -y terradeed-mcp-server@0.1.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.terradeed/terradeed-mcp-server need an API key?

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

Is io.github.terradeed/terradeed-mcp-server open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.terradeed/terradeed-mcp-server?

It is published by terradeed. 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.