Back to Browse

Terradeed MCP Server

Developer ToolsUse Caution4.7MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

4.7
Use Caution4.7High Risk

The TerraDeed MCP server implements x402-based web scraping with proper authentication via Ethereum private key signing. However, critical findings include exposure of the private key in environment configuration documentation, lack of input validation on URLs and schemas, and potential for financial loss due to transaction replay vulnerabilities. While the x402 payment protocol implementation is sophisticated, the security posture is undermined by these issues. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

3 files analyzed · 13 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

network_websocket

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Ethereum private key for signing x402 USDC payments on Base mainnetRequired

Environment variable: TERRADEED_PRIVATE_KEY

How to Install

Add this to your MCP configuration file:

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

Documentation

View on GitHub

From the project's GitHub 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)

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"
      }
    }
  }
}

Links

License

MIT

Reviews

No reviews yet

Be the first to review this server!