Coinrebate

@coinrebate/mcp-server

Read-only MCP server and CLI for crypto exchange trading fees, referral discounts and country availability.

Give your AI agent the published trading fees of Binance, OKX, Bybit, Bitget, Gate.io, Hyperliquid, Aster and the other platforms CoinRebate covers, the fee after CoinRebate's referral discount (for new accounts only; the rate varies by platform and each platform's rules decide eligibility), and the country records CoinRebate keeps for each platform. No API key, no account.

What it is

Other crypto MCP servers (CCXT, exchange-specific ones) give you market data. CoinRebate gives your agent each covered platform's published fees, the cost after the referral discount, and CoinRebate's signup link — plus the referral code when the user's country is known.

CoinRebate takes part in the affiliate or referral programs of the platforms it lists and is not any of them. If a user signs up through CoinRebate's links, CoinRebate may earn a commission at no extra cost to the user. Every answer that carries a signup link or referral code says so next to it; only that link or code is marketing material. The discount applies only to a new account registered through the link, under that platform's own rules, and may not apply at higher VIP levels or to futures trading after a certain period.

What it is not:

• ❌ A custody or wallet service — it places no orders, holds no funds and never signs in to exchange accounts.
• ❌ An investment advisor — nothing it returns is investment advice.
• ❌ Available in every country — see Privacy, logs and regions.

Requirements

• Node.js 18 or later, with npm / npx.
• Outbound HTTPS access to `https://www.coinrebate.vip`. Every tool reads CoinRebate's public REST API (OpenAPI v4.1) at call time; nothing is bundled offline. No API key is needed.
• An MCP client (Claude Desktop, Cursor, Cline, …) for the MCP server, or a terminal for the CLI.

Install

Claude Desktop

Add to claude_desktop_config.json:

{

"mcpServers": { "coinrebate": { "command": "npx", "args": ["-y", "@coinrebate/mcp-server"] } } }

Cursor / Cline / any MCP client

Same npx -y @coinrebate/mcp-server command (stdio transport).

LangChain / CrewAI / AutoGen

from langchain_mcp_adapters import MCPClient

client = MCPClient(command="npx", args=["-y", "@coinrebate/mcp-server"])

No install

The hosted endpoint https://www.coinrebate.vip/api/mcp (streamable HTTP) serves the same tools without installing anything.

Check that it works

1. npx -y @coinrebate/mcp-server --version prints the installed version (2.5.2).
2. npx -y @coinrebate/mcp-server fees binance prints Binance's spot and futures fees before and after the discount. If it fails, check that the machine can reach https://www.coinrebate.vip (or the COINREBATE_API_URL you set).
3. Restart your MCP client: it lists the 11 tools below. Ask "What are Binance's spot trading fees?" and it should call get_exchange_fees. To call the tools by hand instead, run npx @modelcontextprotocol/inspector npx -y @coinrebate/mcp-server.

Three read-only examples

Each call only reads data; nothing is created, changed or sent to an exchange.

1. Compare spot fees for a user in Brazil

• MCP: compare_fees with { "purpose": "spot", "country": "BR" }
• CLI: coinrebate compare --purpose spot --country BR
• Returns the platforms CoinRebate lists for Brazil, lowest taker fee after the referral discount first, each with its signup link.

1. Referral code and signup link for one exchange

• MCP: get_exchange_referral with { "exchange": "bybit", "country": "BR" }
• CLI: coinrebate referral bybit --country BR
• Returns the code, the discount, the signup link and the fees before and after the discount. Without a country it returns the link but not the code.

1. Fee on a monthly volume

• MCP: calculate_trading_cost with { "exchange": "binance", "volume": 50000, "type": "spot", "country": "BR" }
• CLI: coinrebate cost binance --volume 50000 --type spot --country BR
• Returns the taker fee on $50,000 with and without the discount, the difference, and a yearly figure that assumes the volume is monthly.

Command Line

Install once, then call only the tool you need. Human-readable output is the default; add --json for scripts and agents.

npm i -g @coinrebate/mcp-server

coinrebate fees binance coinrebate compare --purpose spot --country BR coinrebate referral bybit --country BR coinrebate cost binance --volume 100000 --type spot coinrebate compliant --country US --purpose spot

Run coinrebate --help for command-specific usage. The existing npx -y @coinrebate/mcp-server command still starts the stdio MCP server.

11 Available Tools (v2.5.2)

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 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 exposed only through the remote

MCP endpoint https://www.coinrebate.vip/api/mcp, which needs no install.

The hosted endpoint exposes all twelve tools. The npm package exposes the eleven tools in the table.

Bundled Agent Skill

The package includes skills/coinrebate-fees/SKILL.md with concise connection, tool-selection, data-basis, and safety instructions for compatible agent runtimes.

Privacy, logs and regions

What leaves your machine. Each tool call goes to CoinRebate's REST API (https://www.coinrebate.vip, or COINREBATE_API_URL if you set it) with that call's parameters — exchange, country, product type, volume, the URL to check or the search phrase — and two headers naming the tool and the package version. The package sends no account, key, cookie or conversation content, and writes nothing to disk.

What CoinRebate records. For each call: the hour (UTC), the tool, whether it was answered, a response-time bracket, coarse parameters (country code, product type, exchange, and a volume bracket instead of the exact amount), the request country reported by our CDN, whether the caller looks like a browser or a bot, and a source identifier calculated from the IP address with a random value replaced every day, so calls cannot be linked across days. For guide searches, the phrase after removing emails, links, wallet addresses, handles and long numbers; for links on domains we do not recognise, only the domain. These per-call records are deleted after 30 days; daily totals are kept for 180 days. The IP address is used in memory for rate limiting and is not written to these records; the web server's standard access logs (about 15 days) do record it. Full policy: https://www.coinrebate.vip/en/legal

Regions. Each platform restricts some countries, and CoinRebate keeps those records per platform. Pass the user's country (ISO 3166-1 alpha-2) and the tools leave out platforms restricted there. Without a country, answers give the signup link but not the referral code; with a country, a code is given only where it may be offered there. Signup links go through https://www.coinrebate.vip/go/…, which checks the region of whoever opens the link and returns HTTP 451 where the platform is restricted; the website and its signup links are also unavailable in mainland China, South Korea, Vietnam, the Philippines, Indonesia and Malaysia. Being on a country's list does not mean a particular person can open an account — each platform's own terms and checks decide.

Data basis

The tools read CoinRebate's public REST API at call time. Fee, rebate and compliance data come from data/exchanges/*.json: fees are the benchmark rates in CoinRebate's published fee table, each with the date its entry was last updated. The data_source / fetched_at fields describe an automated CCXT refresh check, not a verification date. This is a 2026-launched platform in its 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

Changelog

2.5.2 — Maintenance release: it only brings the package build in line with the current source and corrects how the package describes itself; tool names, descriptions and parameters are unchanged. Version 2.5.1 shipped an older build (its news tool still read the news page that stopped updating on 2026-08-06); 2.5.2 is built from the current source and reads the latest-articles endpoint. Answers that carry a signup link or referral code now include the affiliate disclosure, answers that state a referral discount add the VIP / futures-period caveat, a referral code is shown only when the user's country is given, and an unknown country or exchange comes back as the API's own error (for example invalid_country).

License

MIT