# CoinStats MCP
> CoinStats? hosted MCP connects AI clients to live crypto prices and market metrics, wallet balances and history, DeFi positions, exchange data, portfolio P/L, and crypto news.
Canonical: https://www.mcpfolio.com/servers/coinstats
Last updated: 2026-10-28
## Catalog record

- Publisher: CoinStats
- Categories: finance

## Website

https://coinstats.app/mcp/

## Repository

https://github.com/CoinStatsHQ/coinstats-mcp

## Transports

Streamable HTTP; local developer package uses stdio

## 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.

## Tools

- **get-coins**: Get cryptocurrency data including prices, market metrics, price changes, supply, links and metadata.
- **get-coin-by-id**: Get detailed information about a cryptocurrency by its identifier.
- **get-coin-chart-by-id**: Get chart data for a coin over a selected time range.
- **get-coin-avg-price**: Get historical average coin price for a date.
- **get-coin-exchange-price**: Get historical price data for a coin on an exchange.
- **get-market-cap**: Get global market data, BTC dominance and aggregate metrics.
- **get-wallet-balance**: Get wallet balance on a specified blockchain.
- **get-wallet-balances**: Get wallet balances across supported networks.
- **get-wallet-sync-status**: Check wallet synchronization status.
- **get-wallet-transactions**: Get wallet transactions; requires transaction sync first.
- **transactions-sync**: Start wallet transaction synchronization.
- **get-wallet-pl-history**: Get cash-flow-adjusted wallet P/L history for synced networks.
- **get-wallet-defi**: Get wallet DeFi positions including staking, liquidity pools, yield farming and rewards.
- **get-perpetual-positions**: Get perpetual futures positions for a connected exchange account.
- **get-perpetual-trades**: Get perpetual futures trade history for a connected exchange account.
- **get-ticker-exchanges**: List exchanges supported for ticker market data.
- **get-ticker-markets**: Get tickers for a coin across exchanges.
- **get-exchanges**: List supported exchange portfolio connections.
- **get-exchange-balance**: Get balances for a connected exchange account.
- **get-exchange-sync-status**: Check exchange portfolio sync status.
- **get-exchange-transactions**: Get transactions for an exchange connection.
- **get-exchange-pl-history**: Get cash-flow-adjusted P/L history for an exchange portfolio.
- **get-news-sources**: List available crypto news sources.
- **get-news**: Get paginated crypto news.
- **get-news-by-type**: Get crypto news filtered by type.
- **get-news-by-id**: Get a news article by ID.
- **get-portfolio-list**: List the user's portfolios; call first to obtain a portfolioId.
- **get-portfolio-coins**: Get portfolio holdings, P/L and performance metrics.
- **get-portfolio-chart**: Get portfolio performance chart data.
- **get-portfolio-pl-history**: Get cash-flow-adjusted portfolio P/L history.
- **get-portfolio-transactions**: List portfolio transactions.
- **add-portfolio-transaction**: Add a buy/sell transaction to a manual portfolio; requires portfolioId.
- **connect-portfolio-wallet**: Connect a wallet and create a tracked portfolio.
- **connect-portfolio-exchange**: Connect an exchange account and create a tracked portfolio.
- **sync-portfolio**: Trigger portfolio sync; omitting ID syncs all non-manual portfolios at 10x credits.
- **get-portfolio-sync-status**: Check portfolio synchronization status.
- **delete-portfolio**: Permanently delete a portfolio and its transactions; irreversible.
- **get-blockchains**: List supported blockchains.
- **get-fiat-currencies**: List supported fiat currencies.
- **get-currencies**: List supported currencies.

## Sources

- [official_tool_reference](https://coinstats.app/api-docs/mcp/tools/)
- [official_documentation_or_source](https://github.com/CoinStatsHQ/coinstats-mcp)

## Setup

Use the interactive setup panel on [the detail page](https://www.mcpfolio.com/servers/coinstats) to view instructions for each supported client.