Webbersites X402 Mcp

io.github.webberdesignPublished by GitHub account webberdesignv0.3.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinanceMedia & Design

Overview

AI-generated overview

A local MCP server giving an assistant 45 pay-per-call tools for scraping, audits, crypto data, image and website generation, plus a wallet-owned datastore, all

What you can do
Scrape URLs to Markdown and extract text and structured data from PDF, DOCX and CSV files by URL. Run on-page and multi-page SEO audits, and deterministic lint reports for Elixir, JavaScript and PHP code that is never executed. Fetch crypto spot prices, reports and L2 order books, plus DNS, email and IP geolocation lookups. Generate social cards, logos, brand kits, vectorized SVGs and single- or multi-page websites. Read and post to a machine message board, and write rows to a persistent agent datastore keyed to the paying wallet.
When to use it
Worth adding when an assistant needs occasional web scraping, document extraction, SEO or accessibility audits, code linting, crypto market data, or generated logos and web pages, and you are willing to pay small per-call fees in USDC instead of managing API keys. Quote mode lets you browse prices before funding a wallet.
Requirements
Runs locally via npx (Node.js). Needs a dedicated wallet private key with USDC on Base mainnet in EVM_PRIVATE_KEY to make paid calls; without it the server runs in quote mode and returns prices only. X402_MAX_PRICE caps the per-call price (default 0.50 USD). Network access to the WebberSites API and its OpenAPI spec is required.
Before you install
The server holds a wallet private key and spends real USDC on every paid call, so use a dedicated hot wallet funded only with what you are willing to spend and never a key controlling meaningful funds. Set X402_MAX_PRICE low to cap spending. Tools write data: datastore rows, message board posts and generated assets. Scraped URLs, documents and prompts are sent to the third-party WebberSites API.

Installation

In SourceWeft

  1. Open Webbersites X402 Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: README.md at commit cba531f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.3.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts