Skip to main content
Glama
mcp-crypto-toolkit

mcp-crypto-toolkit

by nad33mahm3d

mcp-crypto-toolkit

npm version License: MIT MCP CI Listed on mcpservers.org DeepWiki

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

Demo

Claude.ai Custom Connector — 10 tools

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

Related MCP server: mcp-market-data

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.

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

License

MIT — see LICENSE

Available Tools

10 tools
compare_coinsAInspect

Compare 2–5 cryptocurrencies side by side (price, mcap, volume, 24h change).

Inputs: coins (required), vs_currency.

convertCInspect

Convert crypto amount to fiat/crypto. Optimized PKR via Binance P2P when requested.

Inputs: to (required), from (required), amount (required).

gas_trackerBInspect

Live gas fees for EVM chains (eth, bnb, polygon, arbitrum, base, optimism) with estimated transfer cost in native + USD.

Inputs: chain.

get_priceAInspect

Get live price of any cryptocurrency in any fiat, with market cap, volume, rank, ATH/ATL. Uses CoinGecko.

Inputs: coin (required), vs_currency.

historical_priceCInspect

Historical price on a date (DD-MM-YYYY) with investment snapshot, or a range chart via days (1/7/30/90/365/max).

Inputs: coin (required), date, days, investment, +1 more.

portfolio_valueAInspect

Value a portfolio of holdings in any fiat (batch pricing). Pass [{coin, amount}, ...].

Inputs: holdings (required), vs_currency.

profit_calcBInspect

Calculate crypto profit/loss, ROI, break-even. Supports exchange fees and fixed network/gas fee. No API needed.

Inputs: quantity (required), buy_price (required), sell_price (required), network_fee, +2 more.

search_coinAInspect

Search cryptocurrencies by name or symbol. Returns CoinGecko ids for use in other tools.

Inputs: query (required), limit.

top_coinsBInspect

Top cryptocurrencies by market cap or volume, with gainers/losers among the result set.

Inputs: limit, order, vs_currency.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools have distinct purposes (compare vs. get_price vs. historical_price vs. top_coins). However, there is some overlap: get_price and historical_price both provide pricing but differ in time dimension; compare_coins and top_coins both list multiple coins but one is user-specified, the other market-ranked. These boundaries could be clearer, but descriptions help differentiate.

    Naming Consistency4/5

    Mostly consistent snake_case and descriptive, but a mix of verb_noun (compare_coins, get_price, convert, search_coin, top_coins) and noun (trending, gas_tracker, profit_calc, portfolio_value, historical_price). The deviation is minor and still readable.

    Tool Count5/5

    10 tools is well-scoped for a crypto toolkit covering pricing, conversion, portfolio, gas, and market data. Each tool appears to earn its place without redundancy.

    Completeness4/5

    Covers core needs: live/historical pricing, conversion, portfolio valuation, gas fees, profit calculation, search, trending, comparisons, and top lists. Minor gaps: no direct historical conversion or bulk historical data, but agents can work around with existing tools.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to access real-time on-chain crypto analytics, whale tracking, and market metrics through natural language queries. It provides access to over 245 endpoints for comprehensive data analysis of assets like Bitcoin, Ethereum, and stablecoins.
      7
      90 npm
      9
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Live market data for AI agents. 8 tools: real-time crypto prices, OHLCV candles, order books, market cap rankings, trending coins, technical analysis (RSI/SMA/z-score), asset comparison, and Fear & Greed index. Zero API keys, zero dependencies.
      2
      8
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to fetch live multi-chain portfolio, token info, gas prices, and token prices across Ethereum, Base, Polygon, Arbitrum, and Optimism with a single call. No API key required.
      4
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to fetch crypto market and on-chain data, including prices across venues, token facts, OHLC candles, market overview, DeFi TVL, and wallet balances, with two free tools and the rest paid per call in USDC on Base via x402.
      8
      MIT