Prerequisites
Elite Subscription
MCP requires a RewardSmart Elite plan. Upgrade here →
API Token
Generate in the RewardSmart app under Settings → Integrations → MCP Access.
Claude Desktop
Download and install from claude.ai/download. Version 0.7+ recommended.
Node.js 18+
Required to run the MCP server via npx. Download from nodejs.org.
1 Setup Instructions
-
1
Get your RewardSmart API token
Open the RewardSmart app on your phone. Go to Settings → Integrations → MCP Access and tap Generate Token. Copy the token â you'll need it in a moment.
Keep your token private. It grants access to your card data. You can revoke it at any time from the same settings screen. -
2
Open the Claude Desktop config file
Navigate to the config file for your operating system. Create it if it doesn't exist yet.
On macOS, the config file is located at:
Path~/Library/Application Support/Claude/claude_desktop_config.jsonOpen Terminal and run:
Terminalopen ~/Library/Application\ Support/Claude/On Windows, the config file is located at:
Path%APPDATA%\Claude\claude_desktop_config.jsonOpen File Explorer and paste the path above into the address bar, or press
Win + Rand type%APPDATA%\Claude. -
3
Add the RewardSmart MCP server config
Open
claude_desktop_config.jsonin a text editor and add (or merge) the following. ReplaceYOUR_TOKEN_HEREwith the token you copied in step 1.claude_desktop_config.json{ "mcpServers": { "rewardsmart": { "command": "npx", "args": ["-y", "@rewardsmart/mcp-server"], "env": { "REWARDSMART_API_KEY": "YOUR_TOKEN_HERE" } } } }If the file already has an"mcpServers"key, add the"rewardsmart"block inside it â don't duplicate the outer key. -
4
Restart Claude Desktop
Fully quit and reopen Claude Desktop. On macOS use
Cmd+Q, on Windows right-click the taskbar icon and choose Quit.After restarting, open a new conversation and look for the đ MCP indicator or hammer icon in the chat input area. This confirms RewardSmart is connected.
-
5
Test the connection
Try asking Claude: "Which of my cards gives the best rewards at grocery stores?"
If Claude responds with your actual card data, the integration is working perfectly!
What You Can Ask
Once connected, you can ask Claude natural language questions about your credit card rewards. Here are some examples to get you started:
Troubleshooting
MCP server not showing up in Claude
Make sure you've fully quit Claude Desktop (not just closed the window). Check that your JSON syntax is valid â missing commas or braces are the most common cause. Use a JSON validator like jsonlint.com to check.
"npx: command not found" error
Node.js is not installed or not in your PATH. Install Node.js 18+ from nodejs.org. After installing, restart Claude Desktop.
Authentication error / "Invalid API key"
Double-check that you replaced YOUR_TOKEN_HERE with your actual token. Tokens are long strings â make sure no characters were cut off when copying. You can regenerate a token in the RewardSmart app.
Claude says it can't access my cards
Ensure you have at least one card added to your RewardSmart wallet. Also check your Elite subscription is active in the RewardSmart app under Account → Subscription.
Config file doesn't exist
Create the directory and file manually. On macOS: mkdir -p ~/Library/Application\ Support/Claude && touch ~/Library/Application\ Support/Claude/claude_desktop_config.json. Then paste the JSON config and save.