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

Variable	Default	Purpose
`EVM_PRIVATE_KEY`	—	Paying wallet (USDC on Base). Omit for quote mode.
`X402_MAX_PRICE`	`0.50`	Max USD per call; higher-priced tools are refused.
`X402_OPENAPI_URL`	`https://api.webbersites.com/openapi.json`	Spec the tools are generated from.
`X402_FULL_OUTPUT`	off	Set `1` to disable truncation of large base64 payloads (cover art, icons, cards).

Example tools

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

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

License

MIT