# AwardWallet MCP > AwardWallet lets your AI client manage corporate loyalty points, frequent flyer miles, and complex travel itineraries across multiple users. Connect it to monitor balances, track expirations, and pull unified timelines directly via conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** loyalty-programs, frequent-flyer, travel-itinerary, reward-points, balance-tracking, status-monitoring ## Description Connecting this MCP gives you a single point of access for all corporate travel rewards data. You can talk to your accounts and get immediate answers about points balances or upcoming trips without opening dozens of tabs or digging through emails. Your agent pulls together everything from loyalty program details—whether it's Delta miles or Marriott Bonvoy points—and synthesizes the full picture, including who traveled when and what their status is. For instance, you can check a user’s entire travel timeline, seeing past trips right alongside upcoming flights and hotel reservations. If your team uses multiple systems for tracking rewards, this MCP organizes that data instantly. You'll find it easy to integrate this into your existing agent workflow using Vinkius, making complex reporting simple. ## Tools ### create_auth_url Generates a specific link that lets an individual user authorize your business account to access their data. ### get_account_check Tests the connection to AwardWallet Business API to make sure it's working correctly. ### get_account_details Pulls specific details for a single loyalty program, like current point totals or status tiers. ### get_account_history Retrieves a full record of activities and changes that have happened to a given loyalty account. ### get_user_accounts Lists every single type of loyalty program or reward system tied to one specific user ID. ### get_user_itineraries Pulls detailed travel schedules and confirmation numbers for a specified user's trips. ### get_user_timeline Creates a chronological overview of all known activity, including flights and hotel stays, for one person. ### list_connected_users Lists every user who has granted your business account permission to access their travel data. ### list_loyalty_providers Shows a list of all the major loyalty programs that AwardWallet supports. ## Prompt Examples **Prompt:** ``` List all connected users in my AwardWallet account. ``` **Response:** ``` I've retrieved your connected users. You currently have 3 users authorized: 'John Doe' (ID: 12345), 'Jane Smith' (ID: 67890), and 'Robert Brown'. Which user's rewards would you like to inspect? ``` **Prompt:** ``` Show me the loyalty accounts for user ID '12345'. ``` **Response:** ``` I've fetched the accounts for user 12345. They have 150,000 Delta SkyMiles (Gold Medallion) and 45,000 Marriott Bonvoy points. Note: The Marriott points expire in 3 months. Shall I check for more details? ``` **Prompt:** ``` Get the travel timeline for user '998877'. ``` **Response:** ``` Retrieving timeline... User 998877 has an upcoming flight to London (LHR) on June 15th and a hotel stay at 'The Savoy'. Their last trip was to Tokyo in February. Would you like the full itinerary for the London trip? ``` ## Capabilities ### List connected users Retrieves a list of every individual whose travel and loyalty data you have authorized access to. ### Check account status Verifies the connection credentials for your AwardWallet Business API account. ### Get specific account details Fetches precise information, like current balances or status levels, for any single loyalty program. ### View historical activity Gathers a record of past transactions and changes made to a loyalty account over time. ### Retrieve user accounts list Pulls all the distinct loyalty programs associated with one specific user ID. ### Get detailed travel itineraries Retrieves full schedules, confirmation numbers, and details for past or future trips. ### Generate user timeline view Assembles a chronological overview of all known activity—flights, hotels, etc.—for one person. ## Use Cases ### Auditing corporate accounts after an event The Ops Manager needs to know which department members accrued points and used them for the recent conference. They prompt their agent: 'Show me all users who have activity in Q2.' The MCP then uses `list_connected_users` and `get_account_history` to compile a report, eliminating manual data aggregation. ### Planning an executive trip with limited points The EA needs to book a last-minute flight for the CEO but worries about point availability. They ask: 'What are John Doe's current Delta and Marriott balances?' The agent uses `get_user_accounts` and `get_account_details` to confirm the exact available rewards before booking. ### Tracking a team member’s travel history The Travel Assistant needs to provide context for an upcoming meeting by reviewing past locations. They ask: 'What was Jane Smith's itinerary last quarter?' The agent uses `get_user_timeline` and `get_user_itineraries` to deliver a comprehensive report. ### Onboarding a new department head The manager needs to give the new hire immediate access to corporate rewards data. They use `list_loyalty_providers` first to show what's available, then guide the user through generating an authorization link using `create_auth_url`. ## Benefits - Stop searching emails for status updates. Use `get_account_details` to instantly check a user's current point balance or elite status without digging through old receipts. - Consolidate all employee data. Instead of manually cross-referencing multiple sheets, your agent can use `list_connected_users` and then pull individual reports for everyone at once. - Never miss an expiration date again. By running checks against balances and history, you'll know exactly which points are expiring soon using the tools available here. - Get a full picture of travel. The MCP combines data from `get_user_itineraries` with `get_user_timeline`, giving you one simple view of where someone was, and where they’re going next. - Automate audit reports. If compliance requires knowing every employee's usage, the agent can run background checks using `get_account_history` across multiple users automatically. ## How It Works The bottom line is that once connected, your AI client handles all the API calls; you just ask questions in plain English. 1. First, you subscribe to this MCP and enter your AwardWallet Business API Key into your agent's configuration. 2. Your AI client then uses the `create_auth_url` tool to generate a link. You share that link with the user so they can grant access to their travel data. 3. Finally, you prompt your agent with natural language—like asking for 'John Doe's expiring points'—and it executes the necessary tools to give you an answer. ## Frequently Asked Questions **How do I check all loyalty accounts using get_user_accounts?** You provide the user ID to the agent, and it uses `get_user_accounts` to retrieve a list of every single reward program tied to that specific person. **Can I check expiration dates with get_account_details?** Yes. The tool pulls specific account information which includes monitoring balances and expiry dates for various loyalty programs, so you can flag points needing action. **What is the difference between get_user_itineraries and get_user_timeline?** The MCP uses `get_user_itineraries` for detailed, confirmation-level data on specific trips. Use `get_user_timeline` when you need a broader, chronological overview of all activity over time. **How does create_auth_url work?** It doesn't collect the data itself; it generates a secure link that the user must click and use to grant your business account permission to view their records. **How do I use `list_connected_users` to manage my organization's access?** It lists every user who has authorized your business account. This is critical for security; running this tool shows exactly which team members can see and interact with the rewards data. **What should I do if `get_account_check` returns an error?** The tool verifies your API connection health. If it fails, double-check that you entered the correct AwardWallet Business API Key and ensure your credentials haven't expired. **What kind of data does `get_account_history` provide?** It provides a detailed record of past activity for a loyalty account. You can track not just the balances, but also dates and amounts when points were earned or spent. **How do I use `list_loyalty_providers` to see supported programs?** This tool simply lists every frequent flyer and reward system we support. It helps you quickly confirm if a specific program's points are visible through the MCP. **Can the AI automatically notify me about points that are expiring soon?** Yes! You can ask the agent to check for upcoming point expirations across all connected users. It will use the `get_connected_user_accounts` tool to identify balances at risk and report them to you in seconds. **How do users authorize my business account to see their travel data?** Simply ask the agent to run the `create_auth_url` tool. It will generate a unique authorization link that you can share with your users. Once they click and approve, their data becomes visible to your agent. **Is it possible to retrieve full flight confirmation details through the AI?** Yes. The `get_itinerary` tool allows the agent to fetch complete trip details, including confirmation numbers, flight times, and hotel addresses for any shared trip.