mcp-coinbase

@striderlabs/mcp-coinbase

MCP (Model Context Protocol) server for Coinbase crypto exchange. Provides browser-automated tools for live prices, portfolio management, transaction history, and trading.

Tools

| Tool | Description | |------|-------------| | get_prices | Get current cryptocurrency prices from Coinbase | | get_portfolio | Get your Coinbase portfolio balances and values | | get_transactions | Get recent transaction history | | buy_crypto | Place a buy order (with preview mode) | | sell_crypto | Place a sell order (with preview mode) | | get_wallet_address | Get your deposit address for a cryptocurrency |

Installation

npm install -g @striderlabs/mcp-coinbase
npx playwright install chromium

Or from the tarball:

npm install -g striderlabs-mcp-coinbase-1.0.0.tgz
npx playwright install chromium

Configuration

Set these environment variables before running:

export COINBASE_EMAIL="your@email.com"
export COINBASE_PASSWORD="yourpassword"
export COINBASE_2FA_CODE="123456"   # optional: TOTP code, or leave blank to enter manually

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "coinbase": {
      "command": "mcp-coinbase",
      "env": {
        "COINBASE_EMAIL": "your@email.com",
        "COINBASE_PASSWORD": "yourpassword"
      }
    }
  }
}

Or using npx:

{
  "mcpServers": {
    "coinbase": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-coinbase"],
      "env": {
        "COINBASE_EMAIL": "your@email.com",
        "COINBASE_PASSWORD": "yourpassword"
      }
    }
  }
}

Tool Reference

get_prices

Get current spot prices for one or more cryptocurrencies.

{
  "symbols": ["BTC", "ETH", "SOL"],
  "currency": "USD"
}

Returns live prices fetched from the Coinbase public API — no login required.

get_portfolio

Get your full portfolio with balances and USD values. Requires login.

{}

get_transactions

Get recent transaction history.

{
  "limit": 20
}

buy_crypto

Place a buy order. Use confirm: false (default) to preview the order without executing.

{
  "symbol": "BTC",
  "amount_usd": 100,
  "confirm": false
}

Set confirm: true to execute the trade.

sell_crypto

Place a sell order. Use confirm: false (default) to preview.

{
  "symbol": "ETH",
  "amount_crypto": 0.5,
  "confirm": false
}

get_wallet_address

Get your deposit address for a cryptocurrency.

{
  "symbol": "BTC"
}

2FA Handling

The server handles two-factor authentication gracefully:

• If COINBASE_2FA_CODE is set, it will be used automatically
• Otherwise, the server waits up to 60 seconds for you to complete 2FA in the browser
• The browser session is reused across tool calls to minimize repeated logins

Browser Automation

This package uses Playwright with stealth mode (via playwright-extra + puppeteer-extra-plugin-stealth) to automate the Coinbase web interface. This approach:

• Works with Coinbase's standard web UI
• Handles dynamic page content
• Bypasses basic bot detection via stealth plugin

Development

git clone https://github.com/markswendsen-code/mcp-coinbase
cd mcp-coinbase
npm install
npx playwright install chromium
npm run build

Run in dev mode (with tsx, no build step):

npm run dev

Security Notes

• Never commit your Coinbase credentials to version control
• Use environment variables for all sensitive configuration
• The confirm: false default on buy/sell prevents accidental trades
• Review all trades carefully before setting confirm: true

License

MIT