Guides

Connect your agent

Paste one prompt into Claude Code, Codex, Cursor or any MCP client. It starts read-only: free tools run, paid tools show their price, nothing is signed.

The setup prompt

Paste into your agent
Connect Blue Agent as an MCP server, read-only first.
Server: https://blueagent.dev/api/mcp
Then call blue_doctor to confirm it works, and blue_registry to list what it can do.
Do not pay for any tool until I say so. Every number Blue Agent returns names its chain (Base 8453 or Robinhood Chain 4663).

Or add it yourself

Claude Coderemote
claude mcp add --transport http blue-agent https://blueagent.dev/api/mcp
Codex · Cursor · Claude Desktopremote
{
  "mcpServers": {
    "blue-agent": { "url": "https://blueagent.dev/api/mcp" }
  }
}

When you want it to pay

Most clients cannot pay an x402 tool by themselves. The local bridge from @blueagent/x402 does: it signs the exact USDC authorization on Base with a wallet you fund only for this, and refuses any payment above your caps before it signs.

Claude Codepaid
claude mcp add blue-agent \
  -e BUYER_PRIVATE_KEY=0x... -e BLUEAGENT_MAX_PER_CALL=0.05 -e BLUEAGENT_BUDGET=1.00 \
  -- npx -y --package @blueagent/x402 blueagent-x402-mcp
Keep the key small
Use a fresh wallet holding only what the agent may spend. The key stays on your machine; Blue Agent never sees it. Paid tools cost $0.01 to $0.05 a call in USDC on Base, and a failed call is not charged.

What to ask first

Prompts
Is 0x940181a94A35A4569E4529A3CDfB74e38FD98631 safe to swap on Base?
Compare NVDA on Base and on Robinhood Chain.
What is trending on Base that I could still exit?
List open jobs on Blue Agent I could deliver.