Crypto Portfolio MCP
@kukapay
An MCP server for tracking and managing cryptocurrency portfolio allocations.
Overview
What is 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 using live Binance prices.
How to use Crypto Portfolio MCP?
Install Python 3.10+, clone the repo, and install dependencies (pip install mcp[cli] ccxt matplotlib). Then register the server with an MCP client (e.g., mcp install main.py --name "CryptoPortfolioMCP") and issue natural‑language commands like "Add 0.1 BTC to my portfolio" or "What's my current portfolio summary?".
Key features of Crypto Portfolio MCP
- Add and track cryptocurrency holdings with real‑time Binance prices.
- Fetch current prices for any Binance trading pair.
- Generate visual PNG charts of portfolio value over time.
- Pre‑built analysis prompt with diversification and risk suggestions.
- Persistent SQLite storage of holdings in a local database.
Use cases of Crypto Portfolio MCP
- Track your cryptocurrency portfolio holdings and total value in real time.
- Retrieve current prices from Binance for any supported trading pair.
- Visualize portfolio value changes over time with automatically generated charts.
- Receive analysis and optimization suggestions for your portfolio allocation.
FAQ from Crypto Portfolio MCP
What runtime dependencies does Crypto Portfolio MCP require?
Python 3.10+ and the packages mcp[cli], ccxt, and matplotlib.
How does Crypto Portfolio MCP store portfolio data?
All holdings are persisted in a local SQLite database (portfolio.db) with a schema including coin symbol, amount, and purchase date.
Where does Crypto Portfolio MCP get cryptocurrency prices?
It fetches real‑time prices directly from Binance for any trading pair (e.g., BTC/USDT).
Can Crypto Portfolio MCP generate charts of portfolio history?
Yes. The portfolio_value_history() tool produces a PNG chart showing portfolio value over time.
Does Crypto Portfolio MCP analyze my portfolio for risk and diversification?
Yes. The built‑in analysis prompt provides suggestions based on current holdings and Binance market trends.
