io.github.webberdesign/webbersites-x402-mcp
45 pay-per-call AI agent tools + wallet-owned agent memory. Scraping, SEO, lint, crypto. x402 USDC
Open source Open in the app JSON README (API)
About
45 pay-per-call AI agent tools + wallet-owned agent memory. Scraping, SEO, lint, crypto. x402 USDC
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- webberdesign
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.3.0
- Last push
- 2026-07-09T00:46:37Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:39
- Updated
- 2026-08-29 04:01:39
- Origin id
io.github.webberdesign/webbersites-x402-mcp
README
# webbersites-x402-mcp
[](https://smithery.ai/servers/service-tfij/webbersites-x402)
MCP 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).
No 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.
## 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](https://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](https://x402.webbersites.com/llms-full.txt).
## License
MIT