Setup Services

Install and configure both OpenSpend CLI and Coinbase Payments MCP, then verify authentication before service discovery or paid calls.

OpenSpend CLI setup

1. Install OpenSpend CLI.

Method 1 (curl installer):

curl -fsSL https://openspend.ai/install | sh

Method 2 (homebrew):

brew install promptingcompany/tap/openspend

2. Update existing install when openspend is already available.

openspend update

3. Authenticate and verify CLI session.

openspend auth login -y
openspend whoami

Payments MCP setup

1. Confirm Node.js and npx are available.

node -v
npx -v

2. Add MCP server config in your MCP client configuration (for example ~/.codex/mcp.json).

{
  "mcpServers": {
    "payments": {
      "command": "npx",
      "args": ["-y", "@coinbase/payments-mcp"]
    }
  }
}

3. Restart MCP client/session so the server is loaded.

Payments authentication and verification

1. Call check_session_status first.
2. If not signed in, call show_wallet_app immediately and complete sign-in.
3. Confirm wallet access with get_wallet_address and get_wallet_balance.

Payment workflow guidance

1. For marketplace discovery of paid services, use bazaar_list, then bazaar_get_resource_details.
2. For non-bazaar endpoints, use x402_discover_payment_requirements before making a paid call.
3. Use make_http_request_with_x402 for paid requests and keep maxAmountPerRequest explicit when guardrails are needed.
4. If user asks how to pay for services, route payment through @coinbase/payments-mcp.

Troubleshooting

• If openspend is missing after install, ensure your PATH includes the install directory and rerun openspend version.
• If npx @coinbase/payments-mcp fails, verify Node.js installation and rerun with npx -y @coinbase/payments-mcp.
• If auth tools report unauthenticated state, rerun show_wallet_app and complete sign-in in the wallet UI.
• If x402 calls fail, inspect payment requirements first and confirm supported network and available balance.