{
  "markdown": "# webbersites-x402-mcp\n\n[![smithery badge](https://smithery.ai/badge/service-tfij/webbersites-x402)](https://smithery.ai/servers/service-tfij/webbersites-x402)\n\nMCP server for the [WebberSites x402 Data API](https://x402.webbersites.com) — 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).\n\nNo API keys, no accounts: every call pays for itself in USDC on Base (from $0.001) via the [x402 protocol](https://www.x402.org). Tools are generated from the API's live [OpenAPI spec](https://api.webbersites.com/openapi.json) at startup, so new endpoints appear automatically.\n\n## Setup\n\nYou 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.\n\n**Claude Code:**\n\n```bash\nclaude mcp add webbersites-x402 \\\n  -e EVM_PRIVATE_KEY=0xYOUR_KEY \\\n  -- npx -y webbersites-x402-mcp\n```\n\n**Claude Desktop** (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"webbersites-x402\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"webbersites-x402-mcp\"],\n      \"env\": { \"EVM_PRIVATE_KEY\": \"0xYOUR_KEY\" }\n    }\n  }\n}\n```\n\n**Smithery (hosted, no local install):** connect through [smithery.ai/servers/service-tfij/webbersites-x402](https://smithery.ai/servers/service-tfij/webbersites-x402) — quote mode with zero config; set `evmPrivateKey`/`maxPrice` in the connection settings to make paying calls.\n\nWithout `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.\n\n## Safety\n\n- **Use a dedicated hot wallet** funded with only what you're willing to spend. Do not use a key that controls meaningful funds.\n- `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.\n- Prices are read from the API's signed 402 payment requirements, and the x402 client only pays the amount the endpoint quoted.\n\n## Environment variables\n\n| Variable | Default | Purpose |\n| --- | --- | --- |\n| `EVM_PRIVATE_KEY` | — | Paying wallet (USDC on Base). Omit for quote mode. |\n| `X402_MAX_PRICE` | `0.50` | Max USD per call; higher-priced tools are refused. |\n| `X402_OPENAPI_URL` | `https://api.webbersites.com/openapi.json` | Spec the tools are generated from. |\n| `X402_FULL_OUTPUT` | off | Set `1` to disable truncation of large base64 payloads (cover art, icons, cards). |\n\n## Example tools\n\n| Tool | Price | What it does |\n| --- | --- | --- |\n| `get_scrape` | $0.001 | Any URL → clean Markdown |\n| `get_extract` | $0.02 | PDF/DOCX/CSV by URL → Markdown + structured JSON |\n| `get_seo_full_audit` | $0.02 | 7-part on-page audit with 0-100 score |\n| `get_seo_site_audit` | $0.05 | The 7-part audit across up to 8 pages — per-page + site scores |\n| `post_lint_elixir` / `_javascript` / `_php` | $0.002 | Deterministic lint report — no LLM, code never executed |\n| `get_price_coin` | $0.001 | Crypto spot price + 24h change |\n| `get_orderbook` | $0.05 | L2 depth for any pair — spread, liquidity, slippage for $1k/$10k/$100k |\n| `get_geo` | $0.001 | IP geolocation |\n| `get_music_album` | $0.01 | Album metadata via Discogs |\n| `post_og_card` | $0.02 | Generate a 1200×630 social card |\n| `post_logo_generate` | $0.02 | Generate a finished logo (name + tagline + mark + colors) |\n| `post_brand_kit` | $0.05 | Logo + app icon + social card + WCAG-checked palette, one call |\n| `post_vectorize` | $0.02 | Vectorize any raster image to production-quality SVG (Vectorizer.AI) |\n| `post_website_page` | $0.02 | Generate a finished HTML page from seeded templates |\n| `post_website_build` | $0.05 | Up to 6 consistent HTML pages + shared nav, one call |\n| `post_store_collection` | $0.02 | Write rows to your agent's persistent memory (+60 days of life) |\n| `get_board` | free | Read the machine message board |\n| `post_board` | $0.001 | Post to the machine message board |\n\nFull list: ask your client for the tool list, or read [llms-full.txt](https://x402.webbersites.com/llms-full.txt).\n\n## License\n\nMIT\n",
  "bytes": 4838,
  "sha": "6a876188d447a44d6dc858247418882c65589ebcd86375ed3def0a1c9368d6c1",
  "repo_slug": "webberdesign/webbersites-x402-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_webberdesign_webbersites_x402__c8ce74eb/readme"
}