mcp-crypto-toolkit
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-crypto-toolkit what's the current price of Bitcoin and Ethereum?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_KEYfor higher limits)stdio + HTTP + Cloudflare Workers transports
Related MCP server: mcp-market-data
Quick Install
npx -y mcp-crypto-toolkitInstallation
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/mcpDeploy (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/mcpIn Claude.ai: Settings → Connectors → Add custom connector
Paste the URL above (must include
/mcp)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.
npm install
npx wrangler login
npm run deploy:cfAfter 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)
Fork/connect repo at render.com
New → Blueprint → point at this repo (
render.yamluses the Free plan)After deploy:
https://YOUR-SERVICE.onrender.com/healthSmithery: 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-toolkitPaid 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 |
| Live price + market cap, volume, rank, ATH/ATL |
| Crypto ↔ fiat/crypto conversion |
| Search by name or symbol |
| Top N by market cap/volume + gainers/losers |
| Side-by-side compare 2–5 coins |
| Value a list of holdings |
| Point date or range chart + investment snapshot |
| Gas fees + estimated transfer cost (USD) |
| P&L, ROI, break-even (fees + network fee) |
| Trending coins + Fear & Greed Index |
Prompts
Prompt | Purpose |
| Top coins + trending + market tone |
| Trending coins + Fear & Greed |
| Price + 7d trend for one coin |
| Walk through a P&L calc |
| Gas + transfer cost advice |
Example prompts
What's the current price of Bitcoin and its market cap?
Search for coins matching "pepe"
Show top 10 coins and today's gainers
Compare BTC, ETH, and SOL
Value my portfolio: 0.5 BTC and 2 ETH in USD
What was ETH on 01-01-2024, and what would $1000 then be worth now?
Show SOL's 30-day price range
What's gas on Base right now in USD?
I bought at 100, sold at 120, qty 10, 0.1% fees — profit?
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 inspectorOptional env
Variable | Purpose |
| Higher CoinGecko rate limits (still optional) |
| Use Pro header with your key |
| Worker only: require Bearer / |
| Worker only: default |
| Better gas oracles |
| Optimism gas oracle |
| 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.
DeepWiki — auto-generated architecture docs
Releasing (maintainers)
One-time: npm package Settings → Trusted Publisher → GitHub Actions → repo
nad33mahm3d/mcp-crypto-toolkit, workflowpublish.yml, environmentrelease, allownpm publishUpdate
CHANGELOG.mdCreate a GitHub Release with tag
vX.Y.ZActions 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
Available Tools
10 toolscompare_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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
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.
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.
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.
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
Related MCP Connectors
Live crypto + IDX stock market intelligence for AI agents — 19 tools, no API key.
Pay-per-call on-chain data for AI agents: token, wallet, risk, whale, NFT, tx. No API keys.
Market and on-chain crypto data for AI agents. Pay per call in USDC on Base (x402).
Crypto market data for AI agents: live prices, OHLCV, sentiment, indicators and exchanges.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables 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.790 npm9MIT
- AlicenseAqualityDmaintenanceLive 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.281MIT
- AlicenseAqualityCmaintenanceEnables 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.4MIT
- AlicenseAqualityCmaintenanceEnables 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.8MIT