mcp-crypto-toolkit

mcp-crypto-toolkit

Live crypto prices, conversion, gas tracker, portfolio tools, and calculators for AI agents.

Ask Claude: What's ETH doing? Top 10 coins? Gas on Base? What's my portfolio worth?

Hosted (Claude.ai Custom Connector): https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp
Docs: DeepWiki · mcpservers.org

Features

• Live prices with market cap, volume, rank, ATH/ATL (CoinGecko)
• Convert between crypto and fiat (optimized PKR via Binance P2P when needed)
• Search coins by name/symbol
• Top coins + gainers/losers snapshot
• Compare 2–5 coins side by side
• Portfolio valuation (batch holdings)
• Historical point-in-time + range charts (7d/30d/…)
• EVM gas tracker with USD transfer estimates
• Profit/loss calculator with exchange + network fees
• Trending coins + Crypto Fear & Greed Index
• MCP prompts for common workflows
• Zero config — no API key required (optional COINGECKO_API_KEY for higher limits)
• stdio + HTTP + Cloudflare Workers transports

Quick Install

npx -y mcp-crypto-toolkit

Installation

Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "crypto-toolkit": {
      "command": "npx",
      "args": ["-y", "mcp-crypto-toolkit"]
    }
  }
}

Local build:

{
  "mcpServers": {
    "crypto-toolkit": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/mcp-crypto-toolkit/dist/index.js"]
    }
  }
}

HTTP server

npm run build
npm run start:http
# POST http://localhost:3000/mcp

Deploy (Smithery / remote MCP) — optional

You do not need paid hosting for discoverability. This server already installs via npx -y mcp-crypto-toolkit (stdio) and is listed on the Official MCP Registry. Glama and PulseMCP ingest from there — no Fly/Railway bill required.

Only deploy HTTP if you want a remote /mcp endpoint (e.g. Claude.ai Custom Connector or Smithery URL publish).

Claude.ai Custom Connector

Public hosted endpoint (Cloudflare Workers):

https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp

1. In Claude.ai: Settings → Connectors → Add custom connector
2. Paste the URL above (must include /mcp)
3. You should see 10 tools (get price, convert, trending, …)

Or deploy your own (Cloudflare / Docker / Render) and use https://YOUR-HOST/mcp. After upgrading a hosted server, remove and re-add the connector if tools still show as empty.

Do not put a remote URL in claude_desktop_config.json — that file is stdio-only. For Claude Desktop local use, prefer:

{
  "mcpServers": {
    "crypto-toolkit": {
      "command": "npx",
      "args": ["-y", "mcp-crypto-toolkit"]
    }
  }
}

Cloudflare Workers (recommended remote — free tier)

Uses the web-standard MCP transport (src/worker.ts) — no Docker required.

Live demo: health · MCP

npm install
npx wrangler login
npm run deploy:cf

After deploy: https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/health
Claude / Smithery URL: https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/mcp

Local preview: npm run dev:cf

Optional secrets / vars:

npx wrangler secret put COINGECKO_API_KEY
npx wrangler secret put MCP_API_KEY   # optional: require Bearer / x-api-key on /mcp
# Pro keys also need: wrangler.toml [vars] COINGECKO_PRO = "1"
# Optional: RATE_LIMIT_PER_MINUTE = "60" (default)

CI: add repo secrets CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID — Worker auto-deploys on GitHub Release (and via workflow_dispatch).

Render (free — no credit card)

1. Fork/connect repo at render.com
2. New → Blueprint → point at this repo (render.yaml uses the Free plan)
3. After deploy: https://YOUR-SERVICE.onrender.com/health
4. Smithery: publish https://YOUR-SERVICE.onrender.com/mcp

Free tier sleeps after ~15 min idle; first request may take ~30s to wake.

Docker (local / your own VPS)

docker build -t mcp-crypto-toolkit .
docker run -p 3000:3000 mcp-crypto-toolkit

Paid PaaS (if you outgrow free tier): Fly.io and Railway work with the included fly.toml / railway.toml but are not free long-term.

Optional env: COINGECKO_API_KEY, COINGECKO_PRO=1, gas oracle keys (see table below).

Tools (10)

Tool	Description
get_price	Live price + market cap, volume, rank, ATH/ATL
convert	Crypto ↔ fiat/crypto conversion
search_coin	Search by name or symbol
top_coins	Top N by market cap/volume + gainers/losers
compare_coins	Side-by-side compare 2–5 coins
portfolio_value	Value a list of holdings
historical_price	Point date or range chart + investment snapshot
gas_tracker	Gas fees + estimated transfer cost (USD)
profit_calc	P&L, ROI, break-even (fees + network fee)
trending	Trending coins + Fear & Greed Index

Prompts

Prompt	Purpose
market-overview	Top coins + trending + market tone
whats-trending	Trending coins + Fear & Greed
analyze-coin	Price + 7d trend for one coin
trade-pnl	Walk through a P&L calc
gas-check	Gas + transfer cost advice

Example prompts

1. What's the current price of Bitcoin and its market cap?
2. Search for coins matching "pepe"
3. Show top 10 coins and today's gainers
4. Compare BTC, ETH, and SOL
5. Value my portfolio: 0.5 BTC and 2 ETH in USD
6. What was ETH on 01-01-2024, and what would $1000 then be worth now?
7. Show SOL's 30-day price range
8. What's gas on Base right now in USD?
9. I bought at 100, sold at 120, qty 10, 0.1% fees — profit?
10. What's trending and what's the Fear & Greed index?

Development

git clone https://github.com/nad33mahm3d/mcp-crypto-toolkit
cd mcp-crypto-toolkit
npm install
npm test
npm run build
npm run inspector

Optional env

Variable	Purpose
COINGECKO_API_KEY	Higher CoinGecko rate limits (still optional)
COINGECKO_PRO=1	Use Pro header with your key
MCP_API_KEY	Worker only: require Bearer / x-api-key on /mcp
RATE_LIMIT_PER_MINUTE	Worker only: default 60
ETHERSCAN_API_KEY / BSCSCAN_API_KEY / …	Better gas oracles
OPTIMISM_API_KEY	Optimism gas oracle
PORT	HTTP server port (default 3000)

Without gas API keys, gas falls back to Blocknative then static estimates.

Contributing

See CONTRIBUTING.md for setup, PR guidelines, and the release process.

• Code of Conduct
• Security Policy
• Support
• Changelog
• DeepWiki — auto-generated architecture docs
• mcpservers.org

Releasing (maintainers)

1. One-time: npm package Settings → Trusted Publisher → GitHub Actions → repo nad33mahm3d/mcp-crypto-toolkit, workflow publish.yml, environment release, allow npm publish
2. Update CHANGELOG.md
3. Create a GitHub Release with tag vX.Y.Z
4. Actions publishes to npm via OIDC (no NPM_TOKEN; provenance automatic)

API Credits

• CoinGecko — prices, markets, trending (free tier, no key required)
• Alternative.me — Fear & Greed Index
• Binance P2P — USDT/PKR when converting to PKR
• Etherscan family — optional gas oracles
• Blocknative — gas fallback

License

MIT — see LICENSE