Quickstart

Connect the wallet to an MCP client and make your first paid call.

This is a remote MCP server. There is nothing to install: paste the URL into a client that supports remote MCP, approve the connection, and the tools appear.

1. Add the server

https://wallet.route402.dev/mcp

In Claude, open Settings → Connectors → Add custom connector and paste that URL. For clients that read a config file, use:

{
  "mcpServers": {
    "route402-wallet": {
      "type": "http",
      "url": "https://wallet.route402.dev/mcp"
    }
  }
}

2. Approve the connection

The client discovers the authorization server automatically, registers itself, and sends you to a consent screen. Read it: the permission to spend is granted on its own screen and shows the exact limits it is bound by.

3. Create and fund a wallet

If no wallet exists yet, every tool returns a `needs_setup` result with a link to https://wallet.route402.dev/setup instead of an error. Funding is a human step — an agent cannot fund itself. On a test network, use the Coston2 faucet.

4. Discover, price, call

search_services  { query: 'current temperature for a city' }
describe_service { service_id: '<id from search>' }
estimate_cost    { service_id: '<id>' }
call_service     { service_id: '<id>', args: { city: 'Berlin' } }   ← the only tool that spends

Tools