add-portfolio-transaction
Add a transaction to a manual portfolio.
LABSCO SUMMARY
Market reference data and your own holdings answered by the same server
The coin and news tools are public reference reads, but the wallet and portfolio tools address balances you own: get-wallet-balances sweeps every supported network for one address, and add-portfolio-transaction writes into a manual portfolio rather than only reporting on it. save-share-token caches the portfolio share token locally between sessions, so it is supplied once instead of on every call. Transaction history depends on a sync you start yourself — get-wallet-transactions expects transactions-sync to have run first, and returns whatever the last sync captured.
What it is
A CoinStats API client: 30 tools spanning market data, on-chain wallet balances, exchange portfolio connections, portfolio performance and crypto news.
What you get
- Market reads across all coins with price, market cap, volume and 1h, 24h and 7d change, filterable on rank, price, supply, valuation and risk score
- Historical pricing three ways: chart series over a chosen period, an average price for a given date, and the price on a named exchange
- Wallet balances for an address on one blockchain or across every supported network, with a sync trigger and a sync-status read
- Exchange portfolio connections with balances, sync status and transaction history
- Portfolio views — holdings with P/L, a performance chart and transaction history — plus a write path for adding a transaction to a manual portfolio
- Reference lists for supported exchanges, blockchains, fiat currencies and news sources, and global market data
- News articles by page, by type or by id
Requirements
A CoinStats API key in COINSTATS_API_KEY. Portfolio calls are addressed by shareToken and exchange calls by connectionId, both of which come from your CoinStats account rather than from the tool set.
Setup effort
One command — npx @coinstats/coinstats-mcp
USE CASES
01
Auditing what a wallet holds and what moved through it
One address is swept across every supported network for balances, then a sync is started so the transaction history that comes back is current rather than stale.
02
Reconciling a portfolio after a trade the tracker missed
Holdings and recorded transactions are read first, and the missing fill is written into the manual portfolio with its price, fee and date rather than left as a discrepancy.
03
Pricing a trade you made months ago
Tax and performance questions need the price on a date, not today's. The average for a timestamp and the price on the venue you actually used are both available.
04
Screening for coins that moved while you were away
The coin list filters on price change, market cap, rank, supply and risk score in one call, so the shortlist is built by the query rather than by scrolling.
05
Explaining a price move with the day's headlines
A chart shows that something happened; the news tools say what. Articles can be pulled by date range, by type, or from a named source.
06
Bringing exchange-held balances into the same picture as on-chain ones
Coins sitting on an exchange are invisible to an address lookup. The exchange connections report their own balances and transaction history separately.
30 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get-blockchains
Get a list of supported blockchains by CoinStats.
get-coin-avg-price
Get the historical average price for a specific cryptocurrency based on its unique identifier and a specific date.
get-coin-by-id
Get detailed information about a specific cryptocurrency based on its unique identifier.
get-coin-chart-by-id
Get chart data for a specific cryptocurrency based on its unique identifier, specifying different time ranges.
get-coin-exchange-price
Get the historical price data for a specific cryptocurrency on a particular exchange.
get-coins
Get comprehensive data about all cryptocurrencies: Price, market cap, and volume. Price changes (1h, 24h, 7d). Supply information. Trading metrics. Social links and metadata.
get-currencies
Get a list of fiat currencies supported by CoinStats.
get-exchange-balance
Get the balance data for a provided Exchange.
get-exchange-sync-status
Get the syncing status of the exchange portfolio.
get-exchange-transactions
Get transaction data for a specific exchange.
get-exchanges
Get a list of supported exchange portfolio connections by CoinStats.
get-fiat-currencies
Get a list of fiat currencies supported by CoinStats.
get-market-cap
Get global market data.
get-news
Get news articles with pagination.
get-news-by-id
Get news by id.
get-news-by-type
Get news articles based on a type.
get-news-sources
Get news sources.
get-portfolio-chart
Get portfolio performance chart data.
get-portfolio-coins
Get a list of portfolio coins with P/L and other data displayed on CoinStats web.
get-portfolio-transactions
Get a list of portfolio transactions.
get-share-token
Retrieves the saved portfolio share token from local cache.
get-ticker-exchanges
Get a list of supported exchanges.
get-ticker-markets
Get a list of tickers for a specific cryptocurrency across different exchanges.
get-wallet-balance
Get the balance data for a provided wallet address on a specific blockchain network.
get-wallet-balances
Get the balance data for a provided wallet address on all CoinStats supported networks.
get-wallet-sync-status
Get the syncing status of the wallet with the blockchain network.
get-wallet-transactions
Get transaction data for a specific wallet. Ensure transactions are synced by calling PATCH /transactions first.
save-share-token
Saves the provided portfolio share token to a local cache for future use across sessions.
transactions-sync
Initiate the syncing process to update transaction data for a specific wallet.
BEFORE YOU INSTALL
What to know first
Tools you get
30 tools when we connected. Four tools change something: add-portfolio-transaction, transactions-sync, get-share-token and save-share-token. The hosted OAuth URL needs no key; the self-hosted stdio server needs COINSTATS_API_KEY.
CONTEXT COST
Moderate Standing cost
Rated by the size of the 30 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx @coinstats/coinstats-mcpHosted endpoint
Any MCP client — OAuth
ENDPOINT URL
https://mcp.coinstats.app/mcpAdd this hosted endpoint to your MCP client.
MCP Clients
Claude.ai, Claude Desktop
Settings → Connectors → Add custom connector, paste https://mcp.coinstats.app/mcp and click Add; a browser opens at coinstats.app/openapi/consent to approve
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add coinstats --transport http https://mcp.coinstats.app/mcpCodex
CODEX · TERMINAL
codex mcp add coinstats --url https://mcp.coinstats.app/mcp
codex mcp login coinstatsAny MCP client — npx
ANY MCP CLIENT — NPX · JSON
{
"mcpServers": {
"coinstats": {
"command": "npx",
"args": [
"-y",
"@coinstats/coinstats-mcp"
],
"env": {
"COINSTATS_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Any MCP client — Docker
ANY MCP CLIENT — DOCKER · JSON
{
"mcpServers": {
"coinstats": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"COINSTATS_API_KEY",
"coinstats/coinstats-mcp"
],
"env": {
"COINSTATS_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
