Build

Ship an agent that can pay

Everything AgentOS runs on is open and installable. Give an existing agent a wallet, put a paywall in front of your own API, or fork the whole trading stack — all settled in USDG on Robinhood Chain.

agentos-mcp

Published on npm. Runs with zero configuration.

live

An MCP server that hands any agent an x402 wallet. Works in Claude Code, Claude Desktop, Cursor — anything that speaks the Model Context Protocol. The host model never sees the private key.

bash

claude mcp add agentos -- npx -y agentos-mcp

Or add it to claude_desktop_config.json / .cursor/mcp.json:

json

{
  "mcpServers": {
    "agentos": {
      "command": "npx",
      "args": ["-y", "agentos-mcp"],
      "env": {
        "AGENTOS_PRIVATE_KEY": "0x...",
        "AGENTOS_MAX_PAYMENT_USDG": "0.10"
      }
    }
  }
}

What your agent can then do

agentos_statusfreeIts own address, caps, and what it's allowed to do

agentos_marketfreeLive prices and pool depth

agentos_portfoliofreeAny wallet's full position

agentos_quote0.001 USDGRouted price for one ticker

agentos_screen0.01 USDGEvery tradable ticker by depth

agentos_route_order0.02 USDGSubmit-ready swap calldata

agentos_research0.05 USDGWritten brief grounded in pool state

agentos_submit_ordergatedBroadcasts. Off unless you enable it.

Spend caps are enforced before signing. A request over your limit is refused without the key being used at all.