Skip to main content
Glama
coinbase-mcp-app

coinbase-mcp-app

Unofficial community project. Not affiliated with, endorsed by, or maintained by Coinbase.

One local open-source SEP-1865 MCP App for Coinbase Advanced Trade Spot that renders an interactive 1-click trade confirmation card and live portfolio panel natively inside Google Antigravity, Claude Desktop / Claude Code, and ChatGPT / Codex Desktop — with zero Skybridge lock-in, zero external network calls inside the UI iframe, and zero third-party Python runtime dependencies.

Why Build This?

Capability

Coinbase Generic Remote MCP

Coinbase Official ChatGPT Plugin

coinbase-mcp-app

Antigravity Desktop

Blocked by OAuth client allowlist

Blocked + window.openai lock-in

Native inline card + side pane / sidebar

Claude Desktop / Code

No inline confirmation card

Widget uses ChatGPT-only Skybridge

Native inline card (closed-CSP HTML)

ChatGPT / Codex Desktop

No inline confirmation card

Supported (ChatGPT only)

Native local stdio SEP-1865 card

Execution Safety

Model can call write tools if scoped

Cloud iframe boundary

view-only key + visibility:["app"] + hidden HMAC token + dry-run by default

Runtime Dependencies

Hosted OAuth

Hosted OAuth

Pure Python 3.12+ stdlib (ES256 P-256 + RFC 6979)

Related MCP server: Coinbase MCP Server

Safety First (View-Only & Dry-Run By Default)

  • Fail-closed view-only preflight (GET /api/v3/brokerage/key_permissions): Refuses to start if can_trade or can_transfer is enabled on your Coinbase CDP API key.

  • Hidden app-only buttons: coinbase_order_execute, coinbase_order_cancel, coinbase_order_reject, and coinbase_order_preview_refresh declare _meta.ui.visibility: ["app"] + openai/widgetAccessible: true and reject any raw trade parameters (additionalProperties: false).

  • Ephemeral HMAC tokens stripped from LLM context: _meta["coinbaseApp/confirmationToken"] is never placed in content or structuredContent, rotates on every quote refresh, expires on TTL, and enforces single-use nonces with idempotent check_status: true recovery.

  • Dry-run only out of the box: Clicking Approve Trade (Dry Run) persists a local receipt in owner-only (0700/0600) SQLite and never places a live order. Real money execution requires a separate hardware biometric signer outside the agent harness (macOS Keychain Touch ID / 1Password Touch ID).

  • Exact decimal & cash hygiene: Keeps USD fiat and USDC / stablecoins strictly separate (Coinbase's portfolio endpoint marks both is_cash=true) and preserves exact string decimals.

Quick Install

1. Google Antigravity (1 command)

agy plugin install https://github.com/saariuslystoned/coinbase-mcp-app

Then set COINBASE_KEY_FILE (or place your mode-0600 view-only ECDSA CDP key at ~/.config/coinbase-mcp-app/view-key.json), or try instant synthetic demo mode (--demo). Open Coinbase Spot from the left sidebar or + side-pane menu, or ask:

"Preview buying $10 of BTC-USDC on Coinbase"

2. Claude Desktop / Claude Code

git clone https://github.com/saariuslystoned/coinbase-mcp-app
claude mcp add --scope user coinbase-mcp-app \
  -e COINBASE_KEY_FILE="$HOME/.config/coinbase-mcp-app/view-key.json" \
  -- /path/to/coinbase-mcp-app/bin/coinbase-mcp-app

Or add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "coinbase-mcp-app": {
      "command": "bash",
      "args": ["/path/to/coinbase-mcp-app/bin/coinbase-mcp-app"],
      "env": {
        "COINBASE_KEY_FILE": "/path/to/view-key.json"
      }
    }
  }
}

3. Codex (~/.codex/config.toml)

[mcp_servers.coinbase-mcp-app]
command = "bash"
args = ["/path/to/coinbase-mcp-app/bin/coinbase-mcp-app"]

[mcp_servers.coinbase-mcp-app.env]
COINBASE_KEY_FILE = "/path/to/view-key.json"

Instant Demo Mode (Zero API Key Needed)

Pass --demo (or COINBASE_MCP_DEMO=1) to render the full portfolio panel and 1-click dry-run trade card using clearly badged DEMO · SYNTHETIC data:

./bin/coinbase-mcp-app --demo

Creating a View-Only Coinbase CDP Key

  1. Open the Coinbase Developer Platform portal → API Keys → Create API key.

  2. Select ECDSA (ES256) (Ed25519 is not supported by Coinbase Advanced Trade REST).

  3. Enable View ONLY (Trade OFF, Transfer OFF) and add your IP allowlist.

  4. Save outside any Git repo with owner-only permissions:

    mkdir -p ~/.config/coinbase-mcp-app && chmod 700 ~/.config/coinbase-mcp-app
    chmod 600 ~/.config/coinbase-mcp-app/view-key.json

Development & Verification

# Run pure-stdlib unit + stdio tests (zero third-party Python packages)
python3 -S -m unittest discover -s tests -v

# Validate Antigravity plugin manifest strictly
agy plugin validate --strict .

# Rebuild single-file zero-network @modelcontextprotocol/ext-apps HTML card
cd mcp-app-ui && npm ci && npm run build

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    • OpenFinance gives any AI agent easy trading across every major market through one hosted MCP server. Trade crypto spot and perpetuals on Hyperliquid with market, limit and TWAP orders, leverage and margin control. Trade stocks, indices, commodities, forex and pre-IPO names as Hyperliquid HIP-3 perps. Trade Polymarket prediction markets with odds, order books, positions, PnL and trader leaderboards. Swap and bridge across 40+ EVM chains and Solana with Relay and Jupiter, find memecoins across 200+ chains, launch tokens on Robinhood Chain and Solana, and buy crypto with card, bank or UPI. Write actions are designed to ask for your confirmation first. Connect with OAuth (sign in to OpenFinance and approve) or an API key. Works with Claude, ChatGPT, Cursor, VS Code, Codex and any MCP client. No install. Home: https://openfinance.tech/agents · Docs: https://docs.openfinance.tech · GitHub: https://github.com/openfinance-tech/mcp

    • Warden MCP lets AI agents find tokens, quote swaps and trade onchain on Base, BNB Chain, Robinhood Chain, Arc and Solana, within limits you set. Market tools need no credential: list_chains, search_tokens, trending_tokens, price_history, quote_swap and swap_status. Search by name, ticker or contract address, read USD price candles, and price a swap before committing to it, including cross-chain swaps. Wallet tools act for the wallet whose owner connected the agent, by OAuth sign-in or a wk_ key. agent_permissions shows what the agent may do and its daily limits. prepare_swap builds a trade and hands the owner a review link to sign. With request_session the owner turns on hands-free trading in one tap, and execute_swap then trades within the limits they set. swap_status tracks gasless and cross-chain trades. get_wallet shows holdings on every chain. Gasless trading is available on Base, BNB Chain and Robinhood Chain. Built by Warden Protocol, the team behind Warden Token Terminal.

    • Trade 16 crypto exchanges + MetaTrader 5 from your AI assistant via one MCP connection.

      https://api.algovesta.com/mcp
    • Trade Papertrade BTC and ETH perps from Claude, ChatGPT, Codex, Cursor and any MCP client.

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI agents with access to real-time cryptocurrency data from Coinbase's public API, including prices, market statistics, historical data, and technical analysis, plus simulated wallet transactions for educational purposes.
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Connects Claude Desktop to crypto and brokerage portfolio data via Coinbase and SnapTrade, providing read-only tools to inspect accounts, holdings, prices, and provider health.
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides intelligent cryptocurrency trading assistance using Coinbase Advanced Trade API, with automated technical analysis screening and real-time market insights.
      2
      MIT