Skip to main content

Documentation Index

Fetch the complete documentation index at: https://crushrewards.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

The Crush Rewards MCP server lets AI agents call the Pricing Intelligence API as native tools. The MCP handles wallet setup, multi-chain payment routing, and protocol negotiation automatically — you ask Claude a pricing question, the MCP pays and returns the answer.

​
Install

npx @crush-rewards/mcp-server --setup
The interactive setup walks through:
  1. Generating a multi-chain wallet (Solana + EVM), or skipping if you want to bring your own keys
  2. Wiring the MCP into Claude Code
After setup, fund the wallet with USDC on any of Solana, Base, or Tempo: 
# Show your wallet addresses, balances, and config
npx @crush-rewards/mcp-server --info

# Back up your private keys before funding — mandatory
npx @crush-rewards/mcp-server --export-keys
Per-query pricing is $0.01–$0.02, so a few dollars buys hundreds of queries.
Use a dedicated agent wallet, not your primary wallet. The MCP only needs a small balance to operate.

​
Bring your own keys

Skip the auto-generated wallet by setting both env vars before running setup: 
export CRUSH_EVM_PRIVATE_KEY=0x<your_evm_private_key>
export CRUSH_SOLANA_PRIVATE_KEY=<your_solana_base58_key>
npx @crush-rewards/mcp-server --setup
When both are set, the wallet file is ignored entirely. Both env vars are required together — setting only one is an error.

​
Manual MCP config

If your client doesn’t support automatic MCP setup, add this to your MCP config: 
{
  "mcpServers": {
    "crush-pricing": {
      "command": "npx",
      "args": ["-y", "@crush-rewards/mcp-server"]
    }
  }
}

​
Multi-chain routing

The MCP holds USDC across Solana, Base, and Tempo. On every call, it tries chains in order (Solana → Base → Tempo) and uses the first one with sufficient balance. You don’t need to think about which chain to fund — top up wherever’s convenient. If a chain’s RPC is rate-limited or down, the MCP attempts payment anyway rather than blocking on RPC health. Requests never hang.

​
Configuration

Env varDefaultPurpose
CRUSH_EVM_PRIVATE_KEY(auto)Override EVM key (Base + Tempo)
CRUSH_SOLANA_PRIVATE_KEY(auto)Override Solana key
CRUSH_API_BASEhttps://api.crushrewards.devAPI base URL (HTTPS required)
CRUSH_SOLANA_RPC_URLmainnet-beta public RPCCustom Solana RPC for balance checks
CRUSH_TEMPO_RPC_URLhttps://rpc.tempo.xyzCustom Tempo RPC for balance checks

​
CLI commands

CommandPurpose
npx @crush-rewards/mcp-serverStart the MCP server (default)
... --setupInteractive setup (wallet + Claude Code wiring)
... --export-keysPrint private keys for backup
... --infoShow addresses, balances, and config
... --helpUsage overview

​
What’s next

Available tools

The 13 pricing tools the MCP exposes, with example prompts.

Direct HTTP

Skip the MCP and call the API directly with x402.