{
  "markdown": "# mcp-crypto-toolkit\n\n[![npm version](https://img.shields.io/npm/v/mcp-crypto-toolkit.svg)](https://www.npmjs.com/package/mcp-crypto-toolkit)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-Server-blue.svg)](https://modelcontextprotocol.io)\n[![CI](https://github.com/nad33mahm3d/mcp-crypto-toolkit/actions/workflows/ci.yml/badge.svg)](https://github.com/nad33mahm3d/mcp-crypto-toolkit/actions/workflows/ci.yml)\n[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/nad33mahm3d/mcp-crypto-toolkit)\n[![DeepWiki](https://img.shields.io/badge/DeepWiki-docs-blueviolet)](https://deepwiki.com/nad33mahm3d/mcp-crypto-toolkit)\n\n**Live crypto prices, conversion, gas tracker, portfolio tools, and calculators for AI agents.**\n\nAsk Claude: *What's ETH doing? Top 10 coins? Gas on Base? What's my portfolio worth?*\n\n**Hosted (Claude.ai Custom Connector):** [`https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp`](https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp)  \n**Docs:** [DeepWiki](https://deepwiki.com/nad33mahm3d/mcp-crypto-toolkit) · [mcpservers.org](https://mcpservers.org/servers/nad33mahm3d/mcp-crypto-toolkit)\n\n![Demo](https://raw.githubusercontent.com/nad33mahm3d/mcp-crypto-toolkit/main/demo.gif)\n\n![Claude.ai Custom Connector — 10 tools](https://raw.githubusercontent.com/nad33mahm3d/mcp-crypto-toolkit/main/docs/claude-connector.png)\n\n## Features\n\n- Live prices with market cap, volume, rank, ATH/ATL (CoinGecko)\n- Convert between crypto and fiat (optimized PKR via Binance P2P when needed)\n- Search coins by name/symbol\n- Top coins + gainers/losers snapshot\n- Compare 2–5 coins side by side\n- Portfolio valuation (batch holdings)\n- Historical point-in-time + range charts (7d/30d/…)\n- EVM gas tracker with USD transfer estimates\n- Profit/loss calculator with exchange + network fees\n- Trending coins + Crypto Fear & Greed Index\n- MCP prompts for common workflows\n- **Zero config** — no API key required (optional `COINGECKO_API_KEY` for higher limits)\n- stdio + HTTP + Cloudflare Workers transports\n\n## Quick Install\n\n```bash\nnpx -y mcp-crypto-toolkit\n```\n\n## Installation\n\n### Claude Desktop / Cursor / Windsurf\n\n```json\n{\n  \"mcpServers\": {\n    \"crypto-toolkit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-crypto-toolkit\"]\n    }\n  }\n}\n```\n\nLocal build:\n\n```json\n{\n  \"mcpServers\": {\n    \"crypto-toolkit\": {\n      \"command\": \"node\",\n      \"args\": [\"/ABSOLUTE/PATH/TO/mcp-crypto-toolkit/dist/index.js\"]\n    }\n  }\n}\n```\n\n### HTTP server\n\n```bash\nnpm run build\nnpm run start:http\n# POST http://localhost:3000/mcp\n```\n\n#### Deploy (Smithery / remote MCP) — optional\n\n**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](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.nad33mahm3d/mcp-crypto-toolkit). Glama and PulseMCP ingest from there — no Fly/Railway bill required.\n\nOnly deploy HTTP if you want a **remote** `/mcp` endpoint (e.g. Claude.ai Custom Connector or Smithery URL publish).\n\n#### Claude.ai Custom Connector\n\nPublic hosted endpoint (Cloudflare Workers):\n\n```\nhttps://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp\n```\n\n1. In Claude.ai: **Settings → Connectors → Add custom connector**\n2. Paste the URL above (must include `/mcp`)\n3. You should see **10 tools** (get price, convert, trending, …)\n\nOr 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.\n\nDo **not** put a remote URL in `claude_desktop_config.json` — that file is stdio-only. For Claude Desktop local use, prefer:\n\n```json\n{\n  \"mcpServers\": {\n    \"crypto-toolkit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-crypto-toolkit\"]\n    }\n  }\n}\n```\n\n**Cloudflare Workers (recommended remote — free tier)**\n\nUses the web-standard MCP transport (`src/worker.ts`) — no Docker required.\n\nLive demo: [health](https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/health) · [MCP](https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp)\n\n```bash\nnpm install\nnpx wrangler login\nnpm run deploy:cf\n```\n\nAfter deploy: `https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/health`  \nClaude / Smithery URL: `https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/mcp`\n\nLocal preview: `npm run dev:cf`\n\nOptional secrets / vars:\n\n```bash\nnpx wrangler secret put COINGECKO_API_KEY\nnpx wrangler secret put MCP_API_KEY   # optional: require Bearer / x-api-key on /mcp\n# Pro keys also need: wrangler.toml [vars] COINGECKO_PRO = \"1\"\n# Optional: RATE_LIMIT_PER_MINUTE = \"60\" (default)\n```\n\nCI: add repo secrets `CLOUDFLARE_API_TOKEN` + `CLOUDFLARE_ACCOUNT_ID` — Worker auto-deploys on GitHub Release (and via workflow_dispatch).\n\n**Render (free — no credit card)**\n\n1. Fork/connect repo at [render.com](https://render.com)\n2. New → Blueprint → point at this repo (`render.yaml` uses the **Free** plan)\n3. After deploy: `https://YOUR-SERVICE.onrender.com/health`\n4. Smithery: publish `https://YOUR-SERVICE.onrender.com/mcp`\n\nFree tier sleeps after ~15 min idle; first request may take ~30s to wake.\n\n**Docker (local / your own VPS)**\n\n```bash\ndocker build -t mcp-crypto-toolkit .\ndocker run -p 3000:3000 mcp-crypto-toolkit\n```\n\n**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.\n\nOptional env: `COINGECKO_API_KEY`, `COINGECKO_PRO=1`, gas oracle keys (see table below).\n\n## Tools (10)\n\n| Tool | Description |\n|------|-------------|\n| `get_price` | Live price + market cap, volume, rank, ATH/ATL |\n| `convert` | Crypto ↔ fiat/crypto conversion |\n| `search_coin` | Search by name or symbol |\n| `top_coins` | Top N by market cap/volume + gainers/losers |\n| `compare_coins` | Side-by-side compare 2–5 coins |\n| `portfolio_value` | Value a list of holdings |\n| `historical_price` | Point date or range chart + investment snapshot |\n| `gas_tracker` | Gas fees + estimated transfer cost (USD) |\n| `profit_calc` | P&L, ROI, break-even (fees + network fee) |\n| `trending` | Trending coins + Fear & Greed Index |\n\n## Prompts\n\n| Prompt | Purpose |\n|--------|---------|\n| `market-overview` | Top coins + trending + market tone |\n| `whats-trending` | Trending coins + Fear & Greed |\n| `analyze-coin` | Price + 7d trend for one coin |\n| `trade-pnl` | Walk through a P&L calc |\n| `gas-check` | Gas + transfer cost advice |\n\n## Example prompts\n\n1. *What's the current price of Bitcoin and its market cap?*\n2. *Search for coins matching \"pepe\"*\n3. *Show top 10 coins and today's gainers*\n4. *Compare BTC, ETH, and SOL*\n5. *Value my portfolio: 0.5 BTC and 2 ETH in USD*\n6. *What was ETH on 01-01-2024, and what would $1000 then be worth now?*\n7. *Show SOL's 30-day price range*\n8. *What's gas on Base right now in USD?*\n9. *I bought at 100, sold at 120, qty 10, 0.1% fees — profit?*\n10. *What's trending and what's the Fear & Greed index?*\n\n## Development\n\n```bash\ngit clone https://github.com/nad33mahm3d/mcp-crypto-toolkit\ncd mcp-crypto-toolkit\nnpm install\nnpm test\nnpm run build\nnpm run inspector\n```\n\n### Optional env\n\n| Variable | Purpose |\n|----------|---------|\n| `COINGECKO_API_KEY` | Higher CoinGecko rate limits (still optional) |\n| `COINGECKO_PRO=1` | Use Pro header with your key |\n| `MCP_API_KEY` | Worker only: require Bearer / `x-api-key` on `/mcp` |\n| `RATE_LIMIT_PER_MINUTE` | Worker only: default `60` |\n| `ETHERSCAN_API_KEY` / `BSCSCAN_API_KEY` / … | Better gas oracles |\n| `OPTIMISM_API_KEY` | Optimism gas oracle |\n| `PORT` | HTTP server port (default 3000) |\n\nWithout gas API keys, gas falls back to Blocknative then static estimates.\n\n## Contributing\n\nSee [CONTRIBUTING.md](https://github.com/nad33mahm3d/mcp-crypto-toolkit/blob/main/CONTRIBUTING.md) for setup, PR guidelines, and the release process.\n\n- [Code of Conduct](https://github.com/nad33mahm3d/mcp-crypto-toolkit/blob/main/CODE_OF_CONDUCT.md)\n- [Security Policy](https://github.com/nad33mahm3d/mcp-crypto-toolkit/blob/main/SECURITY.md)\n- [Support](https://github.com/nad33mahm3d/mcp-crypto-toolkit/blob/main/SUPPORT.md)\n- [Changelog](https://github.com/nad33mahm3d/mcp-crypto-toolkit/blob/main/CHANGELOG.md)\n- [DeepWiki](https://deepwiki.com/nad33mahm3d/mcp-crypto-toolkit) — auto-generated architecture docs\n- [mcpservers.org](https://mcpservers.org/servers/nad33mahm3d/mcp-crypto-toolkit)\n\n### Releasing (maintainers)\n\n1. One-time: npm package **Settings → Trusted Publisher** → GitHub Actions → repo `nad33mahm3d/mcp-crypto-toolkit`, workflow `publish.yml`, environment **`release`**, allow **`npm publish`**\n2. Update `CHANGELOG.md`\n3. Create a GitHub Release with tag `vX.Y.Z`\n4. Actions publishes to npm via OIDC (no `NPM_TOKEN`; provenance automatic)\n\n## API Credits\n\n- [CoinGecko](https://www.coingecko.com/) — prices, markets, trending (free tier, no key required)\n- [Alternative.me](https://alternative.me/crypto/fear-and-greed-index/) — Fear & Greed Index\n- [Binance P2P](https://p2p.binance.com/) — USDT/PKR when converting to PKR\n- [Etherscan](https://etherscan.io/) family — optional gas oracles\n- [Blocknative](https://www.blocknative.com/) — gas fallback\n\n## License\n\nMIT — see [LICENSE](https://github.com/nad33mahm3d/mcp-crypto-toolkit/blob/main/LICENSE)\n",
  "bytes": 9407,
  "sha": "bf9d1918cf944103f7ed279fae643552406cdb33bcb12220bdb942bacbc8c800",
  "repo_slug": "nad33mahm3d/mcp-crypto-toolkit",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nad33mahm3d_mcp_crypto_toolkit_8b6d03ab/readme"
}