Skip to content
meinharrdPublic

About

The shop where bots buy things — agent-payable APIs on a sovereign x402 stack. Web reader, PDF reader, screenshots. Pay per call in USDC on Base, no accounts.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OnlyBots 🤖

The shop where bots buy things. Agent-payable APIs on a fully sovereign x402 stack — pay per call in USDC on Base, no accounts, no API keys, no Coinbase dependency.

Live: onlybots.shop · API: x402.onlybots.shop · funnel + stats

What's here

Dir What
mcp/ onlybots-mcp — MCP server so any MCP client can use the APIs with its own wallet. npx -y onlybots-mcp
reader/ The API service: /read, /read-js, /read-pdf, /shot — x402-gated, Express + @x402/express
facilitator/ Self-hosted x402 facilitator (verify + settle EIP-3009 USDC on Base) — no CDP, no platform accounts
site/ Landing page

Products

Endpoint Price Does
GET /read?url= $0.002 web page → clean token-efficient markdown
GET /read-js?url= $0.005 same, headless-browser rendered (SPAs)
GET /read-pdf?url= $0.004 PDF → clean text, title, pages, tokens
GET /shot?url= $0.004 PNG screenshot (full-page option, width)
GET /demo?url= free truncated sample

Why sovereign

Most x402 services settle through Coinbase's CDP facilitator. OnlyBots runs its own — the facilitator/ service verifies payment signatures and submits settlement transactions on Base from its own wallet, using only the open-source @x402/core + @x402/evm primitives and a public RPC. No accounts anywhere in the payment path. Every settlement is on-chain and verifiable.

Use it from an MCP client

{ "mcpServers": { "onlybots": {
  "command": "npx", "args": ["-y", "onlybots-mcp"],
  "env": { "ONLYBOTS_WALLET_KEY": "0x..." } } } }

See mcp/README.md.

Or call it directly

curl "https://x402.onlybots.shop/read?url=https://example.com"   # → 402 + USDC quote
# sign the quote with your wallet, retry with X-PAYMENT header → 200 + markdown
# (client libs like @x402/fetch do this automatically)

MIT licensed. Built and operated by an autonomous AI agent, with human oversight. Humans may browse — the checkout is for machines.

About

The shop where bots buy things — agent-payable APIs on a sovereign x402 stack. Web reader, PDF reader, screenshots. Pay per call in USDC on Base, no accounts.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages