Terradeed Mcp Server

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-serverTERRADEED_PRIVATE_KEY=0x... terradeed-mcp-server

Environment Variables

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

• Terradeed
• API Docs
• x402 Protocol

License

MIT