BotTrunk

A pay-per-call marketplace for AI agents. Agents buy API and human services with USDC over x402 on Algorand — no accounts, no API keys, no subscriptions. The payment is the credential.

Live at bottrunk.com · paid endpoints at https://api.bottrunk.com/s/<slug> · MainNet, settled by the GoPlausible facilitator · entered in the Algorand Global x402 Challenge as a Composite entry.

Try it in two minutes

Give Claude, Cursor or any MCP agent a wallet and a catalog of things it can buy:

npx bottrunk-mcp wallet          # creates ~/.bottrunk/wallet.json, prints the address
# then two sends to that address: 0.3 ALGO first, then the USDC it may spend.
# The USDC opt-in in between happens by itself on the first tool call.
# Already run an Algorand account? Set BOTTRUNK_MNEMONIC instead and skip all of it.

claude mcp add bottrunk -- npx -y bottrunk-mcp     # Claude Code
# Claude Desktop / Cursor: { "mcpServers": { "bottrunk": { "command": "npx", "args": ["-y", "bottrunk-mcp"] } } }

Steps for Claude Desktop, Cursor, VS Code, Cline, Windsurf, Zed, OpenClaw, Hermes Agent, Goose, the OpenAI Agents SDK and LangChain: bottrunk.com/connect.

Ask the agent "what can you buy on BotTrunk?" (free), then "scrape https://example.com/pricing to markdown" — it costs 0.09 USDC, paid from the agent's own wallet, and comes back with the transaction id. Details, caps and configuration in mcp-hub/README.md.

No install? Point any client that takes a remote MCP server at https://mcp.bottrunk.com/mcp — five free read-only tools (catalog, service, live payment instructions, deposit quote, order status). It holds no keys, so it can price the work but never spend; an agent that signs its own transfers answers the endpoint's 402 itself.

No MCP? Any x402 client works — Python, TypeScript or plain curl — see bottrunk.com/docs.

How a paid call works

agent ──POST──▶ api.bottrunk.com/s/scrape-markdown ──▶ 402 + payment requirements (price, payTo, network)
agent ──POST + PAYMENT-SIGNATURE (signed USDC transfer)──▶ gateway ──/verify──▶ facilitator
                                                          gateway runs the service
                                                          gateway ──/settle──▶ facilitator ──▶ Algorand (USDC lands in the gateway wallet)
agent ◀── 200 + result + PAYMENT-RESPONSE receipt ◀── gateway records the 15/85 split in its ledger

Only the settle touches the chain. If the service fails, settle is never called and nothing is charged. The facilitator pays the network fee, so the agent spends USDC only. BotTrunk never holds keys or funds: the transfer goes from the payer straight to the receiving wallet, and the Rails app decides whether to do the work and keeps the books. Full picture with addresses: docs/money-flow.pdf.

What's in the catalog

Service	Price	Status
Pay someone in Honduras — deposit-bac-1000 … -10000: lempiras into any BAC Credomatic account, transferred by a person within 24 h, receipt reference returned	day's BCH rate + 5 % (≈ $42 for L1,000)	live
scrape-markdown — any public page as clean, LLM-ready markdown	0.09 USDC	live
scrape-markdown-js — the same, after the page's JavaScript has run	0.29 USDC	live
screenshot-url — a PNG of a page as a browser renders it, base64	0.08 USDC	live
pdf-url — a page printed to PDF by a real browser, base64	0.10 USDC	live
page-metadata — title, description, OpenGraph, favicon, feeds	0.02 USDC	live
extract-links — every link, absolute, de-duplicated, internal vs external	0.02 USDC	live
url-health — status, redirect chain, timings, TLS issuer and expiry	0.02 USDC	live
domain-dns — A/AAAA/MX/NS/TXT/CNAME plus mail provider, SPF and DMARC hints	0.03 USDC	live
email-check — syntax, MX, and whether an address is disposable, free or a role account	0.002 USDC	live
injection-check — is this text trying to hijack the agent that reads it: clean, suspicious or injection	0.02 USDC	live
tool-call-gate — allow, review or block a command or tool call against the agent's task; hard rules first	0.02 USDC	live
page-kind — article, product, docs… or a login wall, paywall, soft 404 or parked domain	0.02 USDC	live
page-fit — does this page answer my question, and the paragraph that does, quoted

Every price is what the 402 asks for; the deposit tiers reprice hourly from the Banco Central de Honduras reference rate. Services marked on request are real work done by people — write to [email protected] first; their endpoints answer 503 until then, so nothing can be charged by accident. Latency and success rates on the site are measured from settled calls, never estimated: a service with no traffic says so.

Selling: register any HTTP API with a price and BotTrunk hosts it behind the paywall; you collect USDC per call, we keep 15%. Early access at bottrunk.com/sell.

Repository

gateway/     Rails 8.1 — catalog, x402 paywall + proxy, built-in fulfillers, ledger, public site, hosted MCP
mcp-hub/     TypeScript — the `bottrunk-mcp` npm package (MCP server + agent wallet + spend caps)
docs/        architecture, ADRs, x402/Algorand facts, deploy runbook, challenge notes, money-flow diagram, lempira deposits runbook

Gateway design in one line: controllers are skinny, every business action is a service object returning a Result, only app/services/payments/ knows about chains and facilitators, money is integer µUSDC everywhere. Read docs/architecture.md, then docs/x402-algorand.md for everything learned from the real facilitator (headers, v2 payload envelope, Bazaar discovery shape, gasless fee payer).

Run it locally

cd gateway && bundle install && bin/setup && bin/dev      # http://localhost:3000, docs at /docs
bin/rails test                                             # whole paid loop with a fake adapter, no network

cd ../mcp-hub && npm install && npm test                   # real x402 client against an in-process fake gateway

More in gateway/README.md (TestNet payer wallet, bin/pay, bin/send).

Status

• x402 endpoint live on Algorand MainNet with TLS, tagged x402-global-challenge, listed in the Bazaar and on the leaderboard as BotTrunk.
• bottrunk-mcp published to npm.
• Next: more real services, outside sellers, "pay with wallet" for humans, and the orchestration layer that routes an agent's budget across endpoints.

Stack

Ruby 3.3 · Rails 8.1 · PostgreSQL · Propshaft · Tailwind v4 + daisyUI v5 · ViewComponent + Lookbook · Minitest + WebMock · Node 20 · @modelcontextprotocol/sdk · @x402-avm/* · algosdk · Render.

Conventions for contributors and AI assistants: CLAUDE.md. MIT.