MCP Crypto Monitor — Crypto Wallet & Price Monitoring for AI Agents

An MCP (Model Context Protocol) server that gives AI agents the ability to check crypto wallet balances, track token prices, calculate portfolio value, monitor gas prices, and track the Fear & Greed Index — all with zero external dependencies using free public APIs.

Why This Exists

Crypto monitoring tools typically require API keys, paid subscriptions, or heavy SDK installations. This MCP server uses only free public APIs (Blockchain.info, Etherscan, CoinGecko, Binance) with zero pip dependencies — pure Python stdlib. Your AI agent gets 10 crypto monitoring tools out of the box.

No API keys. No paid subscriptions. No pip installs. Just Python stdlib + internet.

Features

• 10 MCP Tools: get_btc_balance, get_eth_balance, get_erc20_balance, get_btc_transactions, get_price, get_price_binance, get_portfolio_value, get_gas_price, get_fear_greed, monitor_address

• Zero dependencies — pure Python stdlib (urllib, json)

• Free APIs only — Blockchain.info, Etherscan, CoinGecko, Binance, alternative.me

• Portfolio calculation — pass your holdings, get total USD value instantly

• STDIO JSON-RPC mode — drop-in for Claude Desktop, Hermes, or any MCP client

• BTC + ETH + ERC20 — address balance checks with transaction history

Quick Start

# STDIO mode (for MCP clients)
python -m src.server --stdio

# Or print the manifest
python -m src.server --manifest

Use as a library

from src.server import MCPCryptoMonitorServer
import json

server = MCPCryptoMonitorServer()

# Get BTC balance
result = server.handle_tool_call("get_btc_balance", {"address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"})
print(json.loads(result))

# Get portfolio value
result = server.handle_tool_call("get_portfolio_value", {
    "holdings": {"BTC": 0.5, "ETH": 10.0, "USDT": 5000.0}
})
print(json.loads(result)["total_value_usd"])

# Get current prices
result = server.handle_tool_call("get_price", {"coins": ["bitcoin", "ethereum", "monero"]})

# Get ETH gas price
result = server.handle_tool_call("get_gas_price", {})

# Get Fear & Greed Index
result = server.handle_tool_call("get_fear_greed", {})

MCP Tool Reference

Integration with MCP Clients

Claude Desktop

{
  "mcpServers": {
    "crypto-monitor": {
      "command": "python",
      "args": ["-m", "src.server", "--stdio"],
      "cwd": "/path/to/mcp-crypto-monitor"
    }
  }
}

Hermes Agent

mcp:
  servers:
    crypto-monitor:
      command: python
      args: ["-m", "src.server", "--stdio"]
      cwd: /path/to/mcp-crypto-monitor

Tests

python -m pytest tests/ -v  # 30 tests, all passing

API Sources

License

MIT

Author

AMEOBIUS — github.com/AMEOBIUS