com.halffee/coinrebate
Compliance-filtered crypto exchange fee comparison and rebate-link routing for AI agents.
Open source Open in the app JSON README (API)
About
Compliance-filtered crypto exchange fee comparison and rebate-link routing for AI agents.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- com.halffee
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 2.3.0
- Last push
- 2026-08-22T20:05:35Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:01:09
- Updated
- 2026-08-29 03:01:09
- Origin id
com.halffee/coinrebate
README
# @coinrebate/mcp-server
> **The only crypto MCP server built on real exchange referral relationships — not just market data.**
Give 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.
[](https://www.npmjs.com/package/@coinrebate/mcp-server)
[](LICENSE)
[](https://modelcontextprotocol.io/)
## Why this exists
Other crypto MCP servers (CCXT, Binance, exchange-specific) give you **read-only market data**.
CoinRebate 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.
We negotiated the referral deals with exchanges. You build the AI agent. Your users keep the savings.
## Quick Start
### Claude Desktop
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"coinrebate": {
"command": "npx",
"args": ["-y", "@coinrebate/mcp-server"]
}
}
}
```
### Cursor / Cline / any MCP client
Same `npx -y @coinrebate/mcp-server` invocation.
### LangChain / CrewAI / AutoGen
```python
from langchain_mcp_adapters import MCPClient
client = MCPClient(command="npx", args=["-y", "@coinrebate/mcp-server"])
```
## Command Line
Install once, then call only the tool you need. Human-readable output is the default; add
`--json` for scripts and agents.
```bash
npm i -g @coinrebate/mcp-server
coinrebate fees binance
coinrebate compare --purpose spot --country CN
coinrebate referral binance --country CN
coinrebate cost binance --volume 100000 --type spot
coinrebate compliant --country US --purpose spot
```
Run `coinrebate <command> --help` for command-specific usage. The existing
`npx -y @coinrebate/mcp-server` command still starts the stdio MCP server.
## 6 Available Tools
| Tool | What it does |
|------|--------------|
| `get_exchange_fees` | Real-time spot + futures fees for all 7 exchanges, with rebate-applied discount fees |
| `compare_fees` | Rank exchanges by lowest effective fee for spot/futures (with country compliance filter) |
| `get_best_referral` | Get the best signup link for a specific exchange (returns code + URL + discount %) |
| `get_latest_news` | Latest crypto news from CoinRebate (use as content source for your agent) |
| `calculate_trading_cost` | Compute actual savings for a given trade volume (great for "show me the money" UX) |
| `get_compliant_exchanges` | Country-filtered exchange list (essential for regulatory compliance — built-in GeoIP) |
> **Also available on the hosted endpoint:** `recommend_fee_option` — instead of a table it returns
> a single verdict ("the lowest effective fee for a user in <country> is X"), together with the
> assumptions behind it and what is deliberately not modelled, and abstains when the upstream data
> is unreliable or the top venues are genuinely tied. It is currently exposed only through the remote
> MCP endpoint `https://coinrebate.vip/api/mcp`, which needs no install. It will land in this npm
> package in a later release.
## Compliance — Built In
Every 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.
Example: 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).
## Real Data Only
This 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.
## Resources
- 🌐 **Website**: https://www.coinrebate.vip
- 🤖 **AI Agent Portal**: https://www.coinrebate.vip/for-agents
- 📋 **OpenAPI v4.1 spec**: https://www.coinrebate.vip/openapi.json
- 📖 **llms.txt**: https://www.coinrebate.vip/llms.txt
- 💬 **Telegram Channel**: https://t.me/coinrebatevip
- 🐛 **Issues**: https://github.com/skheman2026-sketch/coinrebate-mcp-server/issues
## What we are NOT
- ❌ A custody / wallet service (we don't touch funds)
- ❌ An investment advisor (NFA — Not Financial Advice)
- ❌ A YouTube influencer / promo network — we are infrastructure
- ❌ Available in 100% of countries (compliance per exchange)
## License
MIT