botsmith-mcp

An MCP server that gives your agent pay-per-call tools with no API keys and no accounts. Each call is paid automatically in USDC on Base via the x402 protocol from a wallet you control.

Tools are loaded live from botsmith's catalog, so the set grows without updating this package:

• read - fetch any public web page as clean, boilerplate-free markdown ($0.003/call)
• dossier - full domain intelligence: DNS, SPF/DMARC, RDAP registration, live TLS cert, in one call ($0.004/call)
• onchain - EVM address due-diligence across Base/Ethereum/Optimism: contract-or-wallet, scam/reputation flags, balances, verification ($0.004/call)
• pkg-risk - supply-chain risk check for an npm or PyPI package: vulnerabilities, install scripts, typosquat distance, verdict ($0.01/call)
• wallet-risk - counterparty screening for an EVM wallet: OFAC sanctions, scam flags, age, funding origin, 0-100 score ($0.05/call)
• seller-trust - vet any x402 seller before paying: live 402 handshake, requirements validity, Bazaar listing status ($0.008/call)
• models_search / models_get - current LLM landscape as data: context windows and live USD/Mtok pricing ($0.003-0.004/call)
• x_tweet / x_user / x_search - read X (Twitter) posts, profiles and search without an account or API key ($0.005-0.01/call)
• x_dossier - full X account intelligence in one call: profile, recent-activity analytics and a bot-likelihood signal ($0.02/call)
• documents_convert - convert a PDF, Word, Excel, PowerPoint, HTML or CSV document (by URL or inline) into clean markdown ($0.02/call)
• stablecoin_peg - live peg deviation, supply and chain breakdown for any stablecoin ($0.004/call)
• polymarket_markets - the best Polymarket markets to watch right now, ranked ($0.005/call)
• polymarket_market - per-market snapshot with order-book microstructure signals ($0.006/call)

Setup

Add to your MCP client config (Claude Desktop, Claude Code, etc.):

{
  "mcpServers": {
    "botsmith": {
      "command": "npx",
      "args": ["-y", "botsmith-mcp"],
      "env": {
        "BOTSMITH_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
      }
    }
  }
}

BOTSMITH_PRIVATE_KEY is a Base wallet holding a small amount of USDC. Payment is gasless for you (EIP-3009); you only spend the per-call price. Use a dedicated low-balance wallet - treat the key like any hot-wallet secret.

Without a key the server still starts and lists the tools, but paid calls return a message telling you to add one. Point at a different deployment with BOTSMITH_BASE_URL.

How it works

On start the server reads GET https://x402.botsmith.dev/catalog, registers one MCP tool per service route with its JSON Schema, and on each call issues the HTTP request through an x402-paying fetch. A 402 challenge is answered by signing a USDC payment authorization with your wallet and retrying - all inside the tool call, invisible to the agent.

License

MIT