{
  "markdown": "# @coinrebate/mcp-server\n\n> **The only crypto MCP server built on real exchange referral relationships — not just market data.**\n\nGive your AI agents instant access to **permanent trading fee discounts (up to 50% off, varies by exchange)** on Binance, OKX, Bybit, Bitget, Gate.io, Hyperliquid, and Aster DEX. Your users keep the discount on every trade, forever. Zero infrastructure, zero exchange negotiations.\n\n[![npm](https://img.shields.io/npm/v/@coinrebate/mcp-server)](https://www.npmjs.com/package/@coinrebate/mcp-server)\n[![License](https://img.shields.io/npm/l/@coinrebate/mcp-server)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io/)\n\n## Why this exists\n\nOther crypto MCP servers (CCXT, Binance, exchange-specific) give you **read-only market data**.\n\nCoinRebate gives your AI agent something more valuable: **the ability to recommend exchanges to users with permanent fee discounts baked in** — backed by real affiliate agreements with each exchange (the tools return the current code at runtime, so nothing goes stale). When a user signs up via your AI agent, they get a permanent fee discount on every trade.\n\nWe negotiated the referral deals with exchanges. You build the AI agent. Your users keep the savings.\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"coinrebate\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@coinrebate/mcp-server\"]\n    }\n  }\n}\n```\n\n### Cursor / Cline / any MCP client\n\nSame `npx -y @coinrebate/mcp-server` invocation.\n\n### LangChain / CrewAI / AutoGen\n\n```python\nfrom langchain_mcp_adapters import MCPClient\nclient = MCPClient(command=\"npx\", args=[\"-y\", \"@coinrebate/mcp-server\"])\n```\n\n## Command Line\n\nInstall once, then call only the tool you need. Human-readable output is the default; add\n`--json` for scripts and agents.\n\n```bash\nnpm i -g @coinrebate/mcp-server\ncoinrebate fees binance\ncoinrebate compare --purpose spot --country CN\ncoinrebate referral binance --country CN\ncoinrebate cost binance --volume 100000 --type spot\ncoinrebate compliant --country US --purpose spot\n```\n\nRun `coinrebate <command> --help` for command-specific usage. The existing\n`npx -y @coinrebate/mcp-server` command still starts the stdio MCP server.\n\n## 6 Available Tools\n\n| Tool | What it does |\n|------|--------------|\n| `get_exchange_fees` | Real-time spot + futures fees for all 7 exchanges, with rebate-applied discount fees |\n| `compare_fees` | Rank exchanges by lowest effective fee for spot/futures (with country compliance filter) |\n| `get_best_referral` | Get the best signup link for a specific exchange (returns code + URL + discount %) |\n| `get_latest_news` | Latest crypto news from CoinRebate (use as content source for your agent) |\n| `calculate_trading_cost` | Compute actual savings for a given trade volume (great for \"show me the money\" UX) |\n| `get_compliant_exchanges` | Country-filtered exchange list (essential for regulatory compliance — built-in GeoIP) |\n\n\n> **Also available on the hosted endpoint:** `recommend_fee_option` — instead of a table it returns\n> a single verdict (\"the lowest effective fee for a user in <country> is X\"), together with the\n> assumptions behind it and what is deliberately not modelled, and abstains when the upstream data\n> is unreliable or the top venues are genuinely tied. It is currently exposed only through the remote\n> MCP endpoint `https://coinrebate.vip/api/mcp`, which needs no install. It will land in this npm\n> package in a later release.\n\n## Compliance — Built In\n\nEvery tool that returns exchange recommendations supports an optional `country` parameter (ISO 3166-1 alpha-2). When provided, results are filtered against the CoinRebate compliance matrix.\n\nExample: A user from China asking your agent \"where should I trade?\" — pass `country: \"CN\"` to ensure the agent doesn't recommend exchanges that block Chinese users. We programmatically enforce this on `/api/track` redirects too (returns 451 for blocked combinations).\n\n## Real Data Only\n\nThis MCP server fetches live data from `https://www.coinrebate.vip` REST API (OpenAPI v4.1). All fee/rebate/compliance data is dynamically generated from `data/exchanges/*.json` and verified against exchange official rates via CCXT. **No hardcoded marketing inflation.** This is a 2026-launched platform in growth phase, and we're upfront about that.\n\n## Resources\n\n- 🌐 **Website**: https://www.coinrebate.vip\n- 🤖 **AI Agent Portal**: https://www.coinrebate.vip/for-agents\n- 📋 **OpenAPI v4.1 spec**: https://www.coinrebate.vip/openapi.json\n- 📖 **llms.txt**: https://www.coinrebate.vip/llms.txt\n- 💬 **Telegram Channel**: https://t.me/coinrebatevip\n- 🐛 **Issues**: https://github.com/skheman2026-sketch/coinrebate-mcp-server/issues\n\n## What we are NOT\n\n- ❌ A custody / wallet service (we don't touch funds)\n- ❌ An investment advisor (NFA — Not Financial Advice)\n- ❌ A YouTube influencer / promo network — we are infrastructure\n- ❌ Available in 100% of countries (compliance per exchange)\n\n## License\n\nMIT\n",
  "bytes": 5066,
  "sha": "b4f1a4b887a56e4561baf94cccc5154556e28b6c71b81096276ae377d7921dcb",
  "repo_slug": "skheman2026-sketch/coinrebate-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_halffee_coinrebate_dcbaa1a4/readme"
}