Hosting

Remote hosted OAuth server; optional local stdio/Docker developer mode

Transport

Streamable HTTP; local developer package uses stdio

Endpoint

https://mcp.coinstats.app/mcp

Authentication

Hosted endpoint uses OAuth 2.1 with PKCE and Dynamic Client Registration; users sign in at CoinStats and approve access. Alternative self-hosted mode uses COINSTATS_API_KEY.

Requirements

• CoinStats account to use the hosted OAuth server
• MCP client supporting Streamable HTTP and OAuth 2.1
• API credits apply to calls; wallet and DeFi operations cost more than market data

Setup steps

1. For Claude Code: claude mcp add --transport http coinstats https://mcp.coinstats.app/mcp, then run /mcp and sign in.
2. For Codex: codex mcp add coinstats --url https://mcp.coinstats.app/mcp, then codex mcp login coinstats.
3. For Cursor or VS Code, add the remote URL as an HTTP MCP server; sign in when prompted. For Claude Desktop/Claude.ai use Settings ? Connectors ? Add custom connector and authorize CoinStats.
4. Complete OAuth consent in the browser. Verify with a read-only request such as current BTC price or a wallet balance for a public address.
5. For headless/self-hosted usage only, use the documented npm package @coinstats/coinstats-mcp with COINSTATS_API_KEY stored in environment secrets.

The detailed official reference enumerates 40 named tools; its overview/product headline claims 37. This catalog preserves all 40 distinct entries from the detailed reference and records the discrepancy. Actual portfolio tools require account authorization and may have credit costs.

• get-coins

  Get cryptocurrency data including prices, market metrics, price changes, supply, links and metadata.

  01
• get-coin-by-id

  Get detailed information about a cryptocurrency by its identifier.

  02
• get-coin-chart-by-id

  Get chart data for a coin over a selected time range.

  03
• get-coin-avg-price

  Get historical average coin price for a date.

  04
• get-coin-exchange-price

  Get historical price data for a coin on an exchange.

  05
• get-market-cap

  Get global market data, BTC dominance and aggregate metrics.

  06
• get-wallet-balance

  Get wallet balance on a specified blockchain.

  07
• get-wallet-balances

  Get wallet balances across supported networks.

  08
• get-wallet-sync-status

  Check wallet synchronization status.

  09
• get-wallet-transactions

  Get wallet transactions; requires transaction sync first.

  10
• transactions-sync

  Start wallet transaction synchronization.

  11
• get-wallet-pl-history

  Get cash-flow-adjusted wallet P/L history for synced networks.

  12
• get-wallet-defi

  Get wallet DeFi positions including staking, liquidity pools, yield farming and rewards.

  13
• get-perpetual-positions

  Get perpetual futures positions for a connected exchange account.

  14
• get-perpetual-trades

  Get perpetual futures trade history for a connected exchange account.

  15
• get-ticker-exchanges

  List exchanges supported for ticker market data.

  16
• get-ticker-markets

  Get tickers for a coin across exchanges.

  17
• get-exchanges

  List supported exchange portfolio connections.

  18
• get-exchange-balance

  Get balances for a connected exchange account.

  19
• get-exchange-sync-status

  Check exchange portfolio sync status.

  20
• get-exchange-transactions

  Get transactions for an exchange connection.

  21
• get-exchange-pl-history

  Get cash-flow-adjusted P/L history for an exchange portfolio.

  22
• get-news-sources

  List available crypto news sources.

  23
• get-news

  Get paginated crypto news.

  24
• get-news-by-type

  Get crypto news filtered by type.

  25
• get-news-by-id

  Get a news article by ID.

  26
• get-portfolio-list

  List the user's portfolios; call first to obtain a portfolioId.

  27
• get-portfolio-coins

  Get portfolio holdings, P/L and performance metrics.

  28
• get-portfolio-chart

  Get portfolio performance chart data.

  29
• get-portfolio-pl-history

  Get cash-flow-adjusted portfolio P/L history.

  30
• get-portfolio-transactions

  List portfolio transactions.

  31
• add-portfolio-transaction

  Add a buy/sell transaction to a manual portfolio; requires portfolioId.

  32
• connect-portfolio-wallet

  Connect a wallet and create a tracked portfolio.

  33
• connect-portfolio-exchange

  Connect an exchange account and create a tracked portfolio.

  34
• sync-portfolio

  Trigger portfolio sync; omitting ID syncs all non-manual portfolios at 10x credits.

  35
• get-portfolio-sync-status

  Check portfolio synchronization status.

  36
• delete-portfolio

  Permanently delete a portfolio and its transactions; irreversible.

  37
• get-blockchains

  List supported blockchains.

  38
• get-fiat-currencies

  List supported fiat currencies.

  39
• get-currencies

  List supported currencies.

  40

• The hosted service reads portfolio/account data after user approval. It cannot sign transactions, trade, or move crypto funds.
• Portfolio mutations include adding a transaction, connecting a wallet/exchange, syncing, and irreversible portfolio deletion; require explicit user confirmation for destructive actions.
• API credit multipliers vary by operation; official docs state wallet actions use 40?50 credits and DeFi data 400 credits.
• Hosted OAuth and local API-key mode are different implementations/setup paths.

• The CoinStats marketing page says the service exposes 37 tools; its detailed official tools page lists 38 exact names. Count is flagged pending reconciliation.

• official tool reference

  Official detailed reference lists 40 named tools in its current categories, while product/overview headlines claim 37. Catalog stores all 40 enumerated names and explicitly records this publisher count discrepancy.

• official documentation or source

  Official detailed reference lists 40 named tools in its current categories, while product/overview headlines claim 37. Catalog stores all 40 enumerated names and explicitly records this publisher count discrepancy.

Documentation checked 2026-10-28T12:53:18.000Z. Connection has not been runtime tested.