mcpField
T
terradeed-mcp-server

terradeed-mcp-server

Local
github.com/terradeedBrowser Automation0Updated 5d ago
Repository

About terradeed-mcp-server

terradeed-mcp-server connects AI agents to the Terradeed Scrape API for web scraping, schema-based extraction, and USDC balance checks on Base. Scraping and extraction use per-call x402 payments.

Key features

  1. 01Scrape pages into Markdown
  2. 02Extract JSON using a schema
  3. 03Check Base mainnet USDC balances
  4. 04Pay per call through x402

Use cases

  1. 01Retrieve page content for an agent
  2. 02Extract schema-defined fields from pages
  3. 03Check a Base address's USDC balance

MCP support

The MCP server exposes web scraping, structured extraction, and wallet-balance tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "terradeed-terradeed": {
      "command": "npx",
      "args": [
        "-y",
        "terradeed-mcp-server"
      ],
      "env": {
        "TERRADEED_PRIVATE_KEY": "<TERRADEED_PRIVATE_KEY>"
      }
    }
  }
}
Run commandnpx -y terradeed-mcp-server
Environment variables to set
TERRADEED_PRIVATE_KEYSecretEthereum private key for signing x402 USDC payments on Base mainnet

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmterradeed-mcp-server0.1.4

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
urlstringYesThe URL to scrape
render_jsbooleanNoRender JavaScript before scraping (slower, more complete)

Details

From the project 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.