TerraDeed MCP Server
OfficialSummary: Use Terradeed MCP tools to scrape web content, extract structured data, and check USDC balances; the README also advertises property extraction, but that tool is not in the provided schema.
Scrape a public URL into clean, LLM-ready markdown, optionally rendering JavaScript ($0.01 USDC).
Extract structured JSON from a URL using a supplied JSON schema and optional instructions ($0.05 USDC).
Check the USDC balance of an Ethereum address on Base mainnet, defaulting to the payment wallet (free).
Automatically pay x402 costs using
TERRADEED_PRIVATE_KEYwith USDC on Base mainnet.
Uses an Ethereum private key to sign x402 payments in USDC on Base mainnet, and provides a free tool for checking the USDC balance of any Ethereum address (defaulting to the server's payment wallet).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TerraDeed MCP Server Scrape https://news.ycombinator.com to markdown"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 — Named fields back as JSON from any page ($0.05 USDC)
Property extraction — UK commercial property and land intelligence from a listing URL ($0.10 USDC)
Wallet balance checks — Free USDC balance lookups on Base mainnet
Payments are handled transparently via the x402 protocol on Base mainnet using USDC.
Related MCP server: @warppay402/warppay402-mcp-tools
Installation
Via npx (recommended)
TERRADEED_PRIVATE_KEY=0x... npx terradeed-mcp-serverGlobal install
npm install -g terradeed-mcp-server
TERRADEED_PRIVATE_KEY=0x... terradeed-mcp-serverEnvironment Variables
Variable | Required | Description |
| Yes | Ethereum private key for signing x402 payments. Must hold USDC on Base mainnet. |
Tools
terradeed_scrape_url
Clean, LLM-ready markdown from any URL. JavaScript rendering included. Feed web content directly into agent context without parsing HTML.
Cost: $0.01 USDC per call
{
"url": "https://example.com",
"render_js": false
}terradeed_extract_structured
Structured JSON from any webpage. Name the fields you want and get them back with confidence scores. The schema defines exactly what fields to extract.
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_extract_property
UK commercial property and land intelligence from any listing URL. Returns structured data (address, price, site area, use class, tenure, frontage, coordinates), auto-enriched with flood risk, listed buildings, and EPC data. No field configuration needed.
Cost: $0.10 USDC per call
{
"url": "https://example.com/listing",
"render_js": true
}Calls POST /extract/property with { url, js_render }. render_js defaults to true.
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
Available Tools
3 toolsterradeed_check_walletA
Check the USDC balance of a wallet on Base mainnet. Free — no x402 payment required.
Inputs: address.
terradeed_extract_structuredA
Extract structured JSON data from any URL using a provided schema. Cost: $0.05 USDC per call. The schema defines exactly what fields to extract.
Inputs: url (required), schema (required), instructions.
terradeed_scrape_urlA
Scrape any public URL and return clean, LLM-ready markdown. Cost: $0.01 USDC per call. Supports JavaScript-rendered pages.
Inputs: url (required), render_js.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool serves a clearly distinct purpose: scraping to markdown, extracting structured JSON, and checking wallet balance. There is no overlap or ambiguity between them.
All tools follow the consistent 'terradeed_verb_noun' pattern (scrape_url, extract_structured, check_wallet). The naming is uniform and predictable.
With 3 tools, the server is tightly scoped to its core functions of scraping and extraction. Each tool earns its place, and the count is neither too thin nor too heavy.
The core workflow of scraping and structured extraction is well-covered. The only minor gap is the lack of schema management or a listing of predefined schemas, but this is not a critical omission.
Maintenance
Related MCP Connectors
Pay-per-call web tools for agents (extract, summarize, ask, JSON) via x402 USDC on Base.
Pay-per-call web scraping for AI agents via x402 on Base USDC. Six tools, no signup.
Pay-per-fetch web extraction for agents: POST a URL, get clean markdown. x402 USDC on Base.
Web page to JSON fields (by JSON Schema) for agents. Pay per call in USDC on Base via x402.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables extracting clean Markdown from any webpage by paying $0.005 USDC per call via the x402 protocol, with automatic wallet-based payment settlement.10 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to use pay-per-use web scraping, Base blockchain analytics, and PDF text extraction tools, monetized via x402 USDC micropayments.MIT
- AlicenseNot gradedqualityBmaintenanceLets AI agents make automated USDC micro-payments on Base mainnet via x402/MPP to unlock clean structured data from URLs and other pay-per-call tools like Markdown reading, security scans, wallet enrichment, and settlement proof, with no API key or subscription.3 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to call pay-per-use web tools over Streamable HTTP—converting URLs to Markdown, extracting metadata and links, checking URL status, DNS, email domains, WHOIS, robots.txt, and generating domain reports—with per-call USDC payments on Base via x402 and no API keys.MIT