autonomo-mcp
v0.1.2
Published
MCP server for Autonomo: AI agents find x402 APIs, check prices and pay per call in USDG or $AUTONOMO on Robinhood Chain.
Maintainers
Readme
Autonomo MCP server
Give Claude, Codex, Cursor or any MCP client access to Autonomo's paid APIs. The agent finds an API, checks the price and pays per call with x402, in USDG or $AUTONOMO on Robinhood Chain. No API keys and no account: just a wallet.
The server runs on your own computer. Your wallet key stays there and is only used to sign payments.
Tools
| Tool | What it does | Costs |
| --- | --- | --- |
| find_apis | Search Autonomo's APIs (token prices, launches, rug risk, wallets, transactions, page reader). Optionally also the directory of 4K+ x402 projects. | Free |
| get_price | Call an API without paying and show its price. | Free |
| call_api | Pay for one call and return the answer, with the payment link on Blockscout. | Usually 0.01 USDG or 100 $AUTONOMO |
Setup
- Make a new wallet just for your agent, and send it a little USDG (1 USDG is 100 calls) or $AUTONOMO on Robinhood Chain. Paying in $AUTONOMO needs a little ETH once, for the Permit2 approval.
- Add the server to your client (below), with that wallet's private key as
AUTONOMO_WALLET_KEY. - Ask: "Is token 0x… safe? Use Autonomo."
Without a key, find_apis and get_price still work.
Claude Code
claude mcp add autonomo -e AUTONOMO_WALLET_KEY=0xYOUR_AGENT_WALLET_KEY -- npx -y autonomo-mcpOn Windows, start npx through cmd /c. In PowerShell, quote the --:
claude mcp add autonomo -e AUTONOMO_WALLET_KEY=0xYOUR_AGENT_WALLET_KEY '--' cmd /c npx -y autonomo-mcpClaude Desktop, Cursor and others
Add this to the client's MCP config (claude_desktop_config.json, .cursor/mcp.json, …):
{
"mcpServers": {
"autonomo": {
"command": "npx",
"args": ["-y", "autonomo-mcp"],
"env": { "AUTONOMO_WALLET_KEY": "0xYOUR_AGENT_WALLET_KEY" }
}
}
}If the client can't find npx on Windows, use "command": "cmd" and "args": ["/c", "npx", "-y", "autonomo-mcp"].
Codex
In ~/.codex/config.toml:
[mcp_servers.autonomo]
command = "npx"
args = ["-y", "autonomo-mcp"]
env = { AUTONOMO_WALLET_KEY = "0xYOUR_AGENT_WALLET_KEY" }Settings
| Env var | Default | Meaning |
| --- | --- | --- |
| AUTONOMO_WALLET_KEY | none | Private key of the agent's wallet. Needed only for call_api. |
| AUTONOMO_PAY_WITH | usdg | usdg or autonomo, the token used when the agent doesn't say. |
| AUTONOMO_DAILY_USDG | 1 | Most USDG the server will spend per UTC day. |
| AUTONOMO_DAILY_AUTONOMO | 10000 | Most $AUTONOMO the server will spend per UTC day. |
| AUTONOMO_BASE_URL | https://autonomo.fun | Only for testing against a local copy of the site. |
Safety
- It only pays Autonomo gateways (
autonomo.fun/x/...), and only in USDG or $AUTONOMO on Robinhood Chain. - Each call is capped at 0.05 USDG or 5,000 $AUTONOMO, whatever the API asks.
- The daily budget is tracked in
~/.autonomo-mcp/spend.json. - Your MCP client asks before each tool call, so you approve every payment unless you choose to allow it always.
- Use a dedicated wallet with a small balance, never your main wallet.
Develop
npm install
npm run inspectnpm run inspect opens the MCP Inspector so you can try the tools by hand.
