Webbersites X402 Mcp

io.github.webberdesign由 GitHub 帳號 webberdesign 發布v0.3.0更新於 Oct 24, 2026

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

概覽

AI 產生的概覽

本機 MCP 伺服器,為助理提供 45 個按次付費工具,涵蓋擷取、稽核、加密資料、圖像與網站生成,以及錢包綁定的資料儲存。

可以做什麼
將網址擷取為 Markdown,並依網址從 PDF、DOCX、CSV 檔案擷取文字與結構化資料。執行單頁與多頁 SEO 稽核,以及 Elixir、JavaScript、PHP 的確定性程式碼檢查(不執行程式碼)。取得加密貨幣現貨價格、報告與 L2 訂單簿,以及 DNS、郵件和 IP 地理位置查詢。生成社群卡片、Logo、品牌套件、向量化 SVG 和單頁或多頁網站。讀取與發布機器留言板,並向與付費錢包綁定的持久化代理資料儲存寫入資料列。
適用情境
適合需要偶爾進行網頁擷取、文件擷取、SEO 或無障礙稽核、程式碼檢查、加密市場資料,或生成 Logo 與網頁的助理;願意按次支付少量 USDC 而不想管理 API 金鑰時使用。報價模式可先查看價格再為錢包儲值。
執行需求
透過 npx 在本機執行(需要 Node.js)。需在 EVM_PRIVATE_KEY 中提供持有 Base 主網 USDC 的專用錢包私鑰才能發起付費呼叫;未提供則進入報價模式,僅回傳價格。X402_MAX_PRICE 限制單次呼叫價格(預設 0.50 美元)。需要連線至 WebberSites API 及其 OpenAPI 規格的網路存取。
安裝前請注意
伺服器持有錢包私鑰,每次付費呼叫都會花費真實 USDC,請使用僅存入可承受金額的專用熱錢包,切勿使用控制重要資金的私鑰。將 X402_MAX_PRICE 設低以限制支出。部分工具會寫入資料:資料儲存資料列、留言板貼文和生成的素材。擷取的網址、文件和提示詞會傳送至第三方 WebberSites API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Webbersites X402 Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

webbersites-x402-mcp

[smithery badge]

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:

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

Claude Desktop (claude_desktop_config.json):

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

來源:README.md,提交 cba531f

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.3.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分