io.github.terradeed/terradeed-mcp-server
TerraDeed MCP server — x402 web scraping & structured extraction. Pay-per-call with USDC on Base.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
terradeed-mcp-serverclaude mcp add terradeed-mcp-server -e 'TERRADEED_PRIVATE_KEY=<your terradeed_private_key>' -- npx -y terradeed-mcp-server@0.1.4
{
"mcpServers": {
"terradeed-mcp-server": {
"command": "npx",
"args": [
"-y",
"terradeed-mcp-server@0.1.4"
],
"env": {
"TERRADEED_PRIVATE_KEY": "<your terradeed_private_key>"
}
}
}
}
متغيرات البيئة
TERRADEED_PRIVATE_KEYإلزامي سري Ethereum private key for signing x402 USDC payments on Base mainnet
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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
| Variable | Required | Description |
|---|---|---|
TERRADEED_PRIVATE_KEY | Yes | Ethereum 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
الأسئلة الشائعة
ما هو io.github.terradeed/terradeed-mcp-server؟
TerraDeed MCP server — x402 web scraping & structured extraction. Pay-per-call with USDC on Base.
كيف أثبّت io.github.terradeed/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.terradeed/terradeed-mcp-server إلى مفتاح API؟
نعم. يتطلب TERRADEED_PRIVATE_KEY، وتضبطها في إعداداته.
هل io.github.terradeed/terradeed-mcp-server مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون io.github.terradeed/terradeed-mcp-server؟
ينشره terradeed. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.