get_spot_priceLABSCO SUMMARY
Real prices, fake money, and the line drawn clearly.
The table separating real components from simulated ones is the most valuable thing here — it means nobody mistakes the wallet balance for an account. That makes it a teaching tool: the market data is genuine enough to reason about, and the transactions cannot cost anything.
What it is
An MCP server with two clearly separated halves. Prices, market statistics, historical data and technical analysis come from Coinbase's public API and are real. The wallet, purchases and transaction history are an in-memory simulation for learning, and the README labels each component as real or simulated rather than blurring the two.
What you get
- Real market data:
get_spot_price,get_historical_pricesover a time range,get_exchange_rates,search_assets,get_asset_details,get_market_statsfor the last 24 hours andget_popular_pairs analyze_price_data— technical analysis over the fetched series: volatility, trend, support and resistance- A simulated wallet for practice:
simulate_btc_purchaseconverts USD to crypto,get_virtual_walletshows the balance andget_transaction_historylists what happened - A closed demo economy on top of it —
calculate_beer_costturns a spending amount into a crypto quantity andbuy_virtual_beerspends that crypto back, which makes the USD-to-crypto-to-goods loop visible without real funds - 13 tools in total, 8 market data and 5 transaction
Requirements
Nothing for the MCP server — Coinbase's public API needs no key. Node.js 18 or higher and npm 9 or higher; from a clone, npm install in the workspaces and npm run build in mcp-server, then point the client at mcp-server/dist/index.js with COINBASE_API_URL set to https://api.coinbase.com/v2. The separate web frontend needs VITE_OPENAI_API_KEY for its chat and voice features, but that is not part of the MCP path. Coinbase's public API rate-limits some endpoints at 60 requests per hour.
Setup effort
Build from source — git clone https://github.com/Bichev/coinbase-chat-mcp.git
USE CASES
01
Checking a price mid-conversation
Ask for the current spot price or 24-hour statistics for a pair and get the live figure.
02
Looking at how an asset has moved
Pull the historical series over a window and run volatility and trend analysis on it.
03
Learning what a purchase does without risk
Simulate buying with USD and watch the wallet balance and transaction history change.
04
Finding the right ticker to ask about
Search assets by name and read the details before querying prices.
13 tools
Listed in project docs. Your client may show a different list.
get_historical_pricesget_exchange_ratessearch_assetsget_asset_detailsget_market_statsget_popular_pairsanalyze_price_datacalculate_beer_costsimulate_btc_purchasebuy_virtual_beerget_virtual_walletget_transaction_historyBEFORE YOU INSTALL
What to know first
Tools you get
13 tools named in the project's documentation.
Requires
Node.js 18+
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/Bichev/coinbase-chat-mcp.git
cd coinbase-chat-mcp
npm install
cd mcp-server && npm install && cd ..
cd mcp-server && npm run buildAdd the block below to your Claude Desktop config, pointing args at mcp-server/dist/index.js inside the coinbase-chat-mcp folder
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"coinbase-mcp": {
"command": "node",
"args": [
"<YOUR_PATH_TO_COINBASE_CHAT_MCP>/mcp-server/dist/index.js"
],
"env": {
"COINBASE_API_URL": "https://api.coinbase.com/v2",
"LOG_LEVEL": "info"
}
}
}
}
