MCP-1st-Birthday/rewardpilot-smart-wallet

RewardPilot Smart Wallet MCP Server

AI-powered spending forecast and credit card cap risk analysis.

Features

• —📊 Analyze historical spending patterns
• —💰 Calculate current period spending
• —🔮 Project future spending based on daily averages
• —⚠️ Warn about credit card spending cap risks
• —📈 Provide detailed spending analytics

API Endpoints

POST /forecast_spend

Generate spending forecast for a user + card combination.

Request:

{
  "card_id": "c_chase_sapphire_reserve",
  "user_id": "u_alice",
  "reference_date": "2025-01-15"
}

Response (example):

{
  "card_id": "c_chase_sapphire_reserve",
  "user_id": "u_alice",
  "period": "2025-01",
  "current_spend": 2450.75,
  "cap": 3000.0,
  "remaining_until_cap": 549.25,
  "projected_30day_spend": 3200.0,
  "projected_period_spend": 2890.50,
  "cap_risk": false,
  "cap_risk_message": "✅ LOW RISK: You're on track...",
  "risk_level": "low",
  "forecast_details": {
    "days_in_period": 31,
    "days_elapsed": 15,
    "days_remaining": 16,
    "daily_avg_spend": 163.38,
    "transaction_count": 24,
    "largest_transaction": 450.00
  }
}

GET /cards

List all supported cards and their spending caps.

GET /

Health check endpoint.

Supported Cards

• —Chase Sapphire Reserve: $3,000/month dining/travel cap
• —Amex Gold: $25,000/year dining/groceries cap
• —Citi Custom Cash: $500/month category cap
• —Capital One Savor: No cap
• —Discover It: $1,500/quarter rotating categories cap

Notes:

• —Ensure your app.py exposes the Gradio-mounted app (e.g., app = gr.mountgradioapp(...)).
• —For pure FastAPI (without Gradio), switch to a Docker Space or wrap FastAPI with Gradio as shown above.