CoinStats MCP Server: Market Data, Portfolio, News

Overview

The CoinStats MCP Server is a lightweight Model Context Protocol (MCP) server that exposes CoinStats API capabilities—real-time market data, portfolio tracking, and curated crypto news—to MCP-enabled clients. It acts as a secure bridge between your development tools (editors, notebooks, AI assistants that support MCP) and the CoinStats API, so you can fetch coin prices, inspect portfolio positions, and surface relevant articles inside downstream apps without embedding API calls in each client.

This server requires a CoinStats API key and forwards authenticated requests to CoinStats. Developers use it to centralize crypto data access, reduce duplication across tools, and simplify integrations for analytics, dashboards, bots, and research workflows.

Features

• Real-time market data for thousands of cryptocurrencies (prices, market caps, volume).
• Portfolio tracking and position data aggregation for building portfolio UIs or automation.
• Curated crypto news feed for context-aware applications and notifications.
• Simple MCP-compatible deployment with NPX or Docker for local and CI usage.
• Small footprint: minimal setup, MIT-licensed, and easy to include in client MCP configs.
• Build script for local compilation (TypeScript → JavaScript) and packaging.

Installation / Configuration

Prerequisites

• Node.js (for NPX or local build) or Docker
• A CoinStats API key: get one from the CoinStats API Dashboard (https://openapi.coinstats.app)
• Read the CoinStats API docs for rate limits and endpoint semantics: https://coinstats.app/api-docs

Environment variable

Run with NPX (recommended for quick setup)

# Runs the MCP server using npx (no global install)
npx -y @coinstats/coinstats-mcp
# Make sure COINSTATS_API_KEY is set in your shell or in the MCP client config

Run with Docker

# Pull and run the official Docker image
docker run -e COINSTATS_API_KEY=<YOUR_API_KEY> --rm coinstats/coinstats-mcp

Example MCP client configuration (JSON)

{
  "mcpServers": {
    "coinstats-mcp": {
      "command": "npx",
      "args": ["-y", "@coinstats/coinstats-mcp"],
      "env": {
        "COINSTATS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Build locally

# Install dependencies and compile TypeScript to JavaScript
npm run build

License

• MIT License — see the project repository for the full text: https://github.com/CoinStatsHQ/coinstats-mcp

Available Tools

This MCP server provides a small set of domain-specific resources (exposed as MCP tools) to client applications:

• Market Data
  • Spot prices, market capitalization, 24h volume, price changes
  • Historical price series / candlesticks for charting and backtesting
• Portfolio
  • Import or query portfolio positions, balances, and aggregate metrics
  • Support for watchlists and per-asset allocation reporting
• News
  • Aggregated and curated crypto news items suitable for feeds and alerts
  • Meta data (source, timestamp, URL) to drive discovery or summarization

Note: The server requires the CoinStats API key to fetch these resources and respects the provider’s rate limits. Consult the upstream CoinStats API docs for exact field names and data shapes.

Use Cases

• Real-time price widgets
  • Embed a small widget in dashboards or editors that queries Market Data to show current price, 24h change, and sparkline for a given symbol.
• Portfolio dashboards and alerts
  • Use the Portfolio tool to compute portfolio allocation, unrealized gains/losses, and trigger alerts when a position exceeds a threshold.
• News-driven automation
  • Fetch recent News items and feed them to an LLM or rule engine to generate summaries, trading signals, or notification messages.
• Backtesting and analytics
  • Retrieve historical price series for multiple coins, normalize timestamps, and run backtests or feature engineering pipelines in notebooks or local tooling.
• Contextual assistant integrations
  • Provide an AI assistant with up-to-date market and portfolio context so it can answer queries like “What’s my current BTC exposure?” or “Summarize recent news about Ethereum.”

Resources

• GitHub repository (source, issues, contribution guidance): https://github.com/CoinStatsHQ/coinstats-mcp
• CoinStats API Dashboard (get API key): https://openapi.coinstats.app
• CoinStats API documentation: https://coinstats.app/api-docs

If you are new to MCP, consult your MCP client docs for how to add and call external servers/tools. The CoinStats MCP Server requires only the COINSTATS_API_KEY environment variable and can be started via NPX or Docker as shown above.