Crypto Portfolio MCP
Real-time crypto portfolio management and analysis via MCP.
Key Features
Use Cases
README
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.
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
-
Clone the Repository:
bashgit clone https://github.com/kukapay/crypto-portfolio-mcp.git cd crypto-portfolio-mcp -
Install requirements:
bashpip install mcp[cli] ccxt matplotlib -
Install for Claude Desktop:
bashmcp 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.
Star History
Repository Owner
User
Repository Details
Programming Languages
Tags
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
Crypto Trending MCP Server
Real-time trending cryptocurrency data via Model Context Protocol tools.
Crypto Trending MCP Server tracks and monitors the latest trending tokens on CoinGecko, providing real-time insights into the most popular cryptocurrencies. It exposes MCP tools and prompts, such as a Markdown generator for trending token data and a parser prompt for extracting and analyzing the results with AI models. The solution is built for seamless integration with clients like Claude Desktop and allows natural language querying of current crypto trends. Its lightweight and extensible design supports easy deployment and extension.
- ⭐ 6
- MCP
- kukapay/crypto-trending-mcp
Hive Intelligence MCP Server
Unified MCP server delivering advanced cryptocurrency and Web3 analytics.
Hive Intelligence MCP Server provides comprehensive cryptocurrency, DeFi, and Web3 analytics via the Model Context Protocol. It enables AI assistants to access and orchestrate over 200 specialized tools covering market data, on-chain analytics, portfolio tracking, and security analysis. The server offers both dynamic and category-specific analytics through a unified MCP interface, facilitating intelligent tool orchestration for diverse crypto data needs.
- ⭐ 7
- MCP
- hive-intel/hive-crypto-mcp
Coincap MCP
Query live cryptocurrency data through Coincap's public API for desktop AI tools.
Coincap MCP provides seamless access to cryptocurrency market data from Coincap's public API without requiring API keys or registration. Designed to integrate with Claude Desktop using the Model Context Protocol (MCP), it enables users to query crypto asset prices, market capitalization, and a list of available assets. Installation and configuration are streamlined through Smithery or direct setup. The tool includes sample prompts and exposes specialized tools for crypto price lookup and asset listing.
- ⭐ 89
- MCP
- QuantGeekDev/coincap-mcp
Crypto Projects MCP Server
AI-accessible server that delivers comprehensive cryptocurrency project data in structured formats.
Crypto Projects MCP Server provides AI agents with detailed cryptocurrency project data sourced from Mobula.io, accessible via the Model Context Protocol (MCP). It offers both raw JSON and formatted Markdown outputs, making project information easy to parse and consume by large language models. The server features language customization and returns organized details including price, market data, tokenomics, links, investors, and more. Integration with tools like Claude Desktop is supported for seamless AI interactions.
- ⭐ 0
- MCP
- kukapay/crypto-projects-mcp
Crypto Whitepapers MCP Server
Structured crypto whitepaper knowledge base and search server for AI agents.
Crypto Whitepapers MCP Server provides an MCP-compliant server that acts as a structured knowledge base of cryptocurrency project whitepapers for AI agents. It enables searching, loading, indexing, and querying of whitepaper PDFs while supporting integration with Claude Desktop via the Model Context Protocol. The tool implements interactive tools and prompts to help users and AI analyze, search, and extract insights from crypto whitepapers.
- ⭐ 5
- MCP
- kukapay/crypto-whitepapers-mcp
Whale Tracker MCP Server
Monitor and analyze large cryptocurrency transactions using MCP and Whale Alert API integration.
Whale Tracker MCP Server implements the Model Context Protocol to provide real-time monitoring and analysis of large-scale cryptocurrency transactions. Built in Python, it integrates seamlessly with the Whale Alert API and exposes tools, resources, and prompt templates to MCP-compatible clients such as Claude Desktop. This solution enables users to fetch recent whale transactions, retrieve detailed information, and leverage contextual data directly within their LLM-powered workflows.
- ⭐ 44
- MCP
- kukapay/whale-tracker-mcp
Didn't find tool you were looking for?