Setup Services

Setup Services

Install and configure OpenSpend CLI, then optionally configure Coinbase Payments MCP for paid workflows.

Trigger conditions and approval

Use this skill when any of the following is true:

1. command -v openspend fails
2. openspend whoami fails due to auth/session state
3. User explicitly asks to install, update, or authenticate OpenSpend CLI

Before install, update, or authentication steps, get explicit user approval.

OpenSpend CLI preflight checks

command -v openspend || echo "openspend not installed"
openspend version
openspend whoami

OpenSpend CLI setup

1. Install OpenSpend CLI.

Preferred method (homebrew):

brew install promptingcompany/tap/openspend

Alternative method (curl installer) only with explicit user approval:

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

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.