Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • doc-lib-mcp
  • MCP Git Repo Browser
  • Perplexity MCP Server
  • Rami Levy MCP Server
  • Xano MCP Server for Smithery
Back to MCP Servers
crypto-portfolio-mcp

crypto-portfolio-mcp

Public
kukapay/crypto-portfolio-mcp

An MCP server enabling real-time cryptocurrency portfolio tracking, management, price retrieval from Binance, value history visualization, and AI-driven portfolio analysis with persistent SQLite storage.

python
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with crypto-portfolio-mcp

MCP Server

Unlock the full potential of crypto-portfolio-mcp through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

Crypto Portfolio MCP

An MCP server for tracking and managing cryptocurrency portfolio allocations, enabling AI agents to query and optimize portfolio strategies in real time.

GitHub License Python Version Status

Features

  • Portfolio Management: Add and track cryptocurrency holdings with real-time Binance prices.
  • Price Retrieval: Fetch current prices for any Binance trading pair (e.g., BTC/USDT).
  • Value History: Generate visual charts of portfolio value over time.
  • Analysis Prompt: Pre-built prompt for portfolio analysis with diversification and risk suggestions.
  • SQLite Storage: Persistent storage of holdings in a local database.

Installation

Prerequisites

  • Python 3.10+
  • Git (optional, for cloning the repo)
  • A compatible MCP client (e.g., Claude Desktop)

Setup

  1. Clone the Repository:

    git clone https://github.com/kukapay/crypto-portfolio-mcp.git cd crypto-portfolio-mcp
  2. Install requirements:

    pip install mcp[cli] ccxt matplotlib
  3. Install for Claude Desktop:

    mcp install main.py --name "CryptoPortfolioMCP"

    Or update the configuration file manually:

    {
      "mcpServers": {
        "crypto-portfolio-mcp": {
          "command": "python",
          "args": [ "path/to/crypto-portfolio-mcp/main.py" ]
        }
      }
    }
    

Usage

Once installed, interact with the server through an MCP client like Claude Desktop. Below are example commands:

Add a Holding

  • Prompt: "Add 0.1 BTC to my portfolio"
  • Result: Adds 0.1 BTC/USDT to your portfolio and confirms with "Added 0.1 BTC/USDT to portfolio".

Get Current Price

  • Prompt: "What's the current price of ETH on Binance?"
  • Result: Returns "Current price of ETH/USDT on Binance: $2000.50" (example price).

Portfolio Summary

  • Prompt: "What's my current portfolio summary?"
  • Result: Displays a formatted summary, e.g.:
    Portfolio Summary:
    BTC/USDT: 0.1 @ $60000.00 = $6000.00
    ETH/USDT: 2.0 @ $2000.00 = $4000.00
    Total Value: $10000.00
    

Portfolio Value History

  • Prompt: "Show me my portfolio value history"
  • Result: Generates and displays a PNG chart of your portfolio value over time.

Analyze Portfolio

  • Prompt: "Analyze my crypto portfolio"
  • Result: Provides an analysis with suggestions based on current holdings and Binance market trends.

Tools

The server exposes the following tools:

  • get_portfolio_summary: Retrieves a text summary of your current portfolio.
  • add_holding(coin_symbol: str, amount: float): Adds a cryptocurrency holding (e.g., "BTC", 0.1).
  • get_price(coin_symbol: str): Fetches the current price of a trading pair from Binance.
  • portfolio_value_history(): Generates a PNG chart of portfolio value history.

See the source code docstrings for detailed parameter descriptions.

Database

Holdings are stored in a SQLite database (portfolio.db) with the following schema:

CREATE TABLE holdings ( id INTEGER PRIMARY KEY, coin_symbol TEXT, -- e.g., "BTC/USDT" amount REAL, -- Quantity of the asset purchase_date TEXT -- ISO format timestamp )

License

This project is licensed under the MIT License. See LICENSE for details.

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • doc-lib-mcp
    doc-lib-mcp

    Model Context Protocol server enabling document ingestion, chunking, semantic search, and advanced n...

    Added May 30, 2025
  • MCP Git Repo Browser
    MCP Git Repo Browser

    Node.js-based Model Context Protocol server enabling Git repository browsing by providing directory ...

    2 tools
    Added May 30, 2025
  • Perplexity MCP Server
    Perplexity MCP Server

    Provides a Python-based Model Context Protocol interface to the Perplexity API, enabling expert prog...

    Added May 30, 2025
  • Rami Levy MCP Server
    Rami Levy MCP Server

    MCP server enabling integration of Rami Levy's online grocery API with MCP-enabled LLMs, providing p...

    4 tools
    Added May 30, 2025
  • Xano MCP Server for Smithery
    Xano MCP Server for Smithery

    Model Context Protocol server enabling seamless integration between Claude AI and Xano databases wit...

    Added May 30, 2025