Coinrebate

What coinrebate does

coinrebate connects MCP-compatible AI agents to CoinRebate’s public REST API and exposes exchange fee, rebate, referral, compliance, content, and Binance perpetual-market data. Covered exchanges include Binance, OKX, Bybit, Bitget, Gate.io, Hyperliquid, and Aster DEX for the referral program, while fee and comparison results identify the exchanges represented in CoinRebate’s published data.

The server is intended for research, recommendations, and routing rather than account management or trading execution. It does not custody funds or act as an investment adviser. Referral discounts apply to eligible new accounts under each exchange’s own rules.

How it works

The npm package runs as a standard stdio MCP server. At tool-call time, it reads CoinRebate’s API for fee, rebate, referral, news, guide, and compliance information. Fee records include the benchmark rate and the date associated with the published entry; response metadata can also describe automated refresh checks.

Country-aware tools accept an ISO 3166-1 alpha-2 country code. When supplied, exchange recommendations are filtered through CoinRebate’s compliance matrix. This is relevant when an agent is comparing venues for users in jurisdictions with exchange-specific restrictions.

The package also includes tools based on official Binance endpoints. One lists US, Hong Kong, Korean, and Chinese stock and commodity Binance USDⓈ-M perpetuals from exchangeInfo data. Another reads daily, weekly, 30-day, and historical weekly-rank statistics from Binance klines.

Setup and configuration

Run the server through npx without a separate installation:

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

The same npx -y @coinrebate/mcp-server command works with Cursor, Cline, and other MCP clients. For a global command-line installation, use npm i -g @coinrebate/mcp-server; the coinrebate command supports human-readable output by default and --json for scripts and agents.

A hosted MCP endpoint is also available at https://coinrebate.vip/api/mcp, without local installation. The hosted service includes an additional recommend_fee_option tool that is not included in the npm package.

Tools and capabilities

• Retrieve spot and futures maker/taker fees and referral-adjusted rates.
• Rank exchanges for spot or futures trading, optionally by country.
• Find an exchange’s listed referral code, discount, and signup URL.
• Estimate trading costs and savings for a specified volume.
• List compliant exchanges for a country and inspect exchange referral links.
• Check whether a URL uses CoinRebate’s current referral code.
• Read recent CoinRebate news and search published guides by keyword.
• List Binance TradFi perpetuals and retrieve their performance statistics.

The neutral link inspector separates domain verification, reachability, referral-code ownership, country records, and configured rebates. Unknown findings remain unknown; the tool does not declare a link safe, probe unrecognized domains, or suggest replacements.

Limitations and notes

Referral discounts are exchange-specific and generally depend on registering a new account through the relevant link. A valid referral URL does not guarantee eligibility. Compliance results reflect CoinRebate’s matrix and should be passed a country code when the user’s jurisdiction matters.

Fee comparisons use CoinRebate’s published benchmark table and referral adjustments. Trading-cost calculations estimate taker-fee costs; yearly figures treat the supplied volume as monthly. News and guide results are informational content, not trading instructions or referral links.

The npm distribution currently provides the local tool set, while the hosted endpoint provides the additional recommendation tool. CoinRebate may receive commissions from covered exchanges. The package is licensed under MIT.