Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

BotTrunk

БесплатноНе проверен

Pay-per-call AI services for agents: USDC over x402 on Algorand, paid from your own wallet.

GitHubEmbed

Описание

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-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.

from github.com/JorgePadilla/BotTrunk

Установка BotTrunk

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/JorgePadilla/BotTrunk

FAQ

BotTrunk MCP бесплатный?

Да, BotTrunk MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для BotTrunk?

Нет, BotTrunk работает без API-ключей и переменных окружения.

BotTrunk — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить BotTrunk в Claude Desktop, Claude Code или Cursor?

Открой BotTrunk на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

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

GitHub Actionsавтор: GitHub Actions
83

Roblox Studio

Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce

paralovавтор: paralov

Antigravity Drawio

MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.

S-SUJAN-Sавтор: S-SUJAN-S

Fetch

Web content fetching and conversion for efficient LLM usage.

автор: Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

modelcontextprotocolавтор: modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.

автор: Community

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

xuzexin-hzавтор: xuzexin-hz

MCP-Agent

A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)

lastmile-aiавтор: lastmile-ai

Spring AI MCP Client

Provides auto-configuration for MCP client functionality in Spring Boot applications.

автор: Community

mcp.natoma.ai

A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)

автор: Community

Compare BotTrunk with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории ai