BotTrunk
FreeNot checkedPay-per-call AI services for agents: USDC over x402 on Algorand, paid from your own wallet.
About
Pay-per-call AI services for agents: USDC over x402 on Algorand, paid from your own wallet.
README
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 |
0.02 USDC | live |
Get real supplier quotes — rfq-global: a person phones and emails up to ten suppliers anywhere and returns structured quotes; five business days or refunded |
250 USDC | live |
verify-business-hn — a local visits the address, photographs it, checks the registry |
45 USDC | live |
translate-es-en — human translation and review, up to 1,000 words |
60 USDC | live |
human-review — a person judges your material and puts their name on the answer |
3 USDC | live |
prices-hn — farmgate coffee, the basic basket, fuel and the street dollar, observed in person |
0.05 USDC | on request |
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-mcppublished 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.
Installing BotTrunk
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/JorgePadilla/BotTrunkFAQ
Is BotTrunk MCP free?
Yes, BotTrunk MCP is free — one-click install via Unyly at no cost.
Does BotTrunk need an API key?
No, BotTrunk runs without API keys or environment variables.
Is BotTrunk hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install BotTrunk in Claude Desktop, Claude Code or Cursor?
Open BotTrunk on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Opencode Omniroute Plugin
OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc
by GitHub ActionsRoblox Studio
Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce
by paralovAntigravity Drawio
MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.
by S-SUJAN-SFetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzMCP-Agent
A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)
by lastmile-aiSpring AI MCP Client
Provides auto-configuration for MCP client functionality in Spring Boot applications.
mcp.natoma.ai
A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)
Compare BotTrunk with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All ai MCPs
