English Français العربية

io.github.webberdesign/webbersites-x402-mcp

السجل الرسمي أدوات المطورين

45 pay-per-call AI agent tools + wallet-owned agent memory. Scraping, SEO, lint, crypto. x402 USDC

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package webbersites-x402-mcp
Claude Code 
claude mcp add webbersites-x402-mcp -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'X402_MAX_PRICE=<X402_MAX_PRICE>' -- npx -y webbersites-x402-mcp@0.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "webbersites-x402-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "webbersites-x402-mcp@0.3.0"
            ],
            "env": {
                "EVM_PRIVATE_KEY": "<your evm_private_key>",
                "X402_MAX_PRICE": "<X402_MAX_PRICE>"
            }
        }
    }
}

متغيرات البيئة

  • EVM_PRIVATE_KEY سري 0x… private key of a dedicated hot wallet holding USDC on Base mainnet; each tool call pays for itself. Omit to run in quote mode (tools return prices and payment requirements instead of data).
  • X402_MAX_PRICE Maximum USD price per call; more expensive tools are refused before any payment. Default 0.50 (10x headroom — prices currently range $0.001-$0.05); lower it to cap spend harder.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. webbersites-x402-mcp
  2. Setup
  3. Safety
  4. Environment variables
  5. Example tools
  6. License

webbersites-x402-mcp

MCP server for the WebberSites x402 Data API — 45 pay-per-call tools for AI agents: web scraping, document extraction (PDF/DOCX/CSV), SEO/schema/accessibility audits (single page or whole site), deterministic code lint (Elixir · JavaScript · PHP — no LLM, code never executed), crypto prices / reports / L2 order books, DNS and email intelligence, IP geolocation, album metadata, icon/logo/brand-kit and social-card generation, single- and multi-page website generation, a machine message board (free to read), and a wallet-owned Agent Datastore — give your agent a memory: rows you write persist across sessions, the paying wallet is the identity, and activity keeps it alive (writes add 60 days, reads add 30).

No API keys, no accounts: every call pays for itself in USDC on Base (from $0.001) via the x402 protocol. Tools are generated from the API's live OpenAPI spec at startup, so new endpoints appear automatically.

Setup

You need a wallet private key holding a little USDC on Base mainnet. Fund it with a dollar; that's ~1,000 of the cheapest calls.

Claude Code:

claude mcp add webbersites-x402 \
  -e EVM_PRIVATE_KEY=0xYOUR_KEY \
  -- npx -y webbersites-x402-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "webbersites-x402": {
      "command": "npx",
      "args": ["-y", "webbersites-x402-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0xYOUR_KEY" }
    }
  }
}

Smithery (hosted, no local install): connect through smithery.ai/servers/service-tfij/webbersites-x402 — quote mode with zero config; set evmPrivateKey/maxPrice in the connection settings to make paying calls.

Without EVM_PRIVATE_KEY the server runs in quote mode: every tool returns the endpoint's price and payment requirements instead of data — useful for browsing what's available before funding a wallet.

Safety

  • Use a dedicated hot wallet funded with only what you're willing to spend. Do not use a key that controls meaningful funds.
  • X402_MAX_PRICE (default 0.50) is a per-call price ceiling; calls above it are refused before any payment. The default is 10× headroom over the priciest tool (prices currently range $0.001–$0.05). Lower it to cap spend harder — e.g. X402_MAX_PRICE=0.005 restricts to the cheapest tools.
  • Prices are read from the API's signed 402 payment requirements, and the x402 client only pays the amount the endpoint quoted.

Environment variables

VariableDefaultPurpose
EVM_PRIVATE_KEY—Paying wallet (USDC on Base). Omit for quote mode.
X402_MAX_PRICE0.50Max USD per call; higher-priced tools are refused.
X402_OPENAPI_URLhttps://api.webbersites.com/openapi.jsonSpec the tools are generated from.
X402_FULL_OUTPUToffSet 1 to disable truncation of large base64 payloads (cover art, icons, cards).

Example tools

ToolPriceWhat it does
get_scrape$0.001Any URL → clean Markdown
get_extract$0.02PDF/DOCX/CSV by URL → Markdown + structured JSON
get_seo_full_audit$0.027-part on-page audit with 0-100 score
get_seo_site_audit$0.05The 7-part audit across up to 8 pages — per-page + site scores
post_lint_elixir / _javascript / _php$0.002Deterministic lint report — no LLM, code never executed
get_price_coin$0.001Crypto spot price + 24h change
get_orderbook$0.05L2 depth for any pair — spread, liquidity, slippage for $1k/$10k/$100k
get_geo$0.001IP geolocation
get_music_album$0.01Album metadata via Discogs
post_og_card$0.02Generate a 1200×630 social card
post_logo_generate$0.02Generate a finished logo (name + tagline + mark + colors)
post_brand_kit$0.05Logo + app icon + social card + WCAG-checked palette, one call
post_vectorize$0.02Vectorize any raster image to production-quality SVG (Vectorizer.AI)
post_website_page$0.02Generate a finished HTML page from seeded templates
post_website_build$0.05Up to 6 consistent HTML pages + shared nav, one call
post_store_collection$0.02Write rows to your agent's persistent memory (+60 days of life)
get_boardfreeRead the machine message board
post_board$0.001Post to the machine message board

Full list: ask your client for the tool list, or read llms-full.txt.

License

MIT

الأسئلة الشائعة

ما هو io.github.webberdesign/webbersites-x402-mcp؟

45 pay-per-call AI agent tools + wallet-owned agent memory. Scraping, SEO, lint, crypto. x402 USDC

كيف أثبّت io.github.webberdesign/webbersites-x402-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add webbersites-x402-mcp -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'X402_MAX_PRICE=<X402_MAX_PRICE>' -- npx -y webbersites-x402-mcp@0.3.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.webberdesign/webbersites-x402-mcp إلى مفتاح API؟

نعم. يتطلب EVM_PRIVATE_KEY، وتضبطها في إعداداته.

هل io.github.webberdesign/webbersites-x402-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.webberdesign/webbersites-x402-mcp؟

ينشره webberdesign. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.