MCP-1st-Birthday/rewardpilot-rewards-rag

RewardPilot Rewards-RAG MCP Server

MCP-style FastAPI server that recommends the best credit card for a given transaction using vector search over card rules and offers.

• —Track: building-mcp-track-consumer
• —Input: MCC, amount, geo
• —Output: Best card ID, name, reward value, reward rate, explanation, citations.

This server is used by the RewardPilot Smart Wallet (Track 2), but can also be used as a standalone MCP tool in IDEs or agents.

Status

• —[ ] API implemented
• —[ ] Deployed
• —[ ] Example request/response in this README

Example Request / Response

Request (JSON)

{
  "mcc": 5411,
  "amount": 42.50,
  "geo": "US"
}

Response (JSON)

{
  "best_card_id": "card_abc123",
  "best_card_name": "Platinum Rewards Card",
  "reward_value": 1.28,
  "reward_rate": "3%",
  "explanation": "3% back on dining for this merchant category; no category cap applies.",
  "citations": [
    "rule_987",
    "offer_654"
  ]
}