AwardWallet MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AW_API_KEY | No | Account Access API key. | |
| AW_MOCK_MODE | No | Built-in demo data; nothing is sent to AwardWallet. | false |
| AW_READ_ONLY | No | Register read-only tools only. | false |
| AW_API_KEY_FILE | No | Path to a file containing the Account Access API key. | |
| AW_CONNECT_LINKS | No | Offer create_connection_link. | false |
| AW_EMAIL_API_REGION | No | eu keeps Email Parsing data in AwardWallet's EU infrastructure. | us |
| AW_SECURE_INPUT_URL | No | Public base URL of that page when tunneled. | |
| AW_SECURE_INPUT_PORT | No | Fixed port for the secure input page. | |
| AW_CC_BONUS_CREDENTIALS | No | Credit Card Bonus API credentials in the form username:password. | |
| AW_CONNECT_REDIRECT_URL | No | Needed only if your business has several Redirect URLs configured. | |
| AW_WEB_PARSING_CREDENTIALS | No | Web Parsing (Loyalty) API credentials in the form username:password. | |
| AW_HOTEL_SEARCH_CREDENTIALS | No | Hotel Award Search API credentials in the form username:password. | |
| AW_CC_BONUS_CREDENTIALS_FILE | No | Path to a file containing the Credit Card Bonus API credentials in the form username:password. | |
| AW_EMAIL_PARSING_CREDENTIALS | No | Email Parsing API credentials in the form username:password. | |
| AW_FLIGHT_SEARCH_CREDENTIALS | No | Flight Award Search API credentials in the form username:password. | |
| AW_WEB_PARSING_CREDENTIALS_FILE | No | Path to a file containing the Web Parsing (Loyalty) API credentials in the form username:password. | |
| AW_HOTEL_SEARCH_CREDENTIALS_FILE | No | Path to a file containing the Hotel Award Search API credentials in the form username:password. | |
| AW_EMAIL_PARSING_CREDENTIALS_FILE | No | Path to a file containing the Email Parsing API credentials in the form username:password. | |
| AW_FLIGHT_SEARCH_CREDENTIALS_FILE | No | Path to a file containing the Flight Award Search API credentials in the form username:password. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_statusA | Shows which AwardWallet APIs this server can use and where each credential comes from, whether demo or read-only mode is on, and how many people and accounts the AwardWallet Business account can see. Useful to explain missing data or configuration errors. |
| list_peopleA | Lists the people whose loyalty accounts your AwardWallet Business account can see: connected AwardWallet users (with the account and trip access each one granted) and members you added in the business interface, with how many accounts each has. Returns the userId and memberId values other tools accept. |
| list_loyalty_accountsA | Lists loyalty accounts (airline miles, hotel points, credit-card rewards, rentals, shopping, ...) with balance, elite status, last change, update status and everything that expires on them (points, certificates and other sub-accounts such as free nights or companion passes, elite status), one compact row per account, plus a summary of upcoming expirations and accounts with update problems. Filter by person, program, type, balance or an expiration date. For one account's full properties and transaction history use get_loyalty_account. |
| get_loyalty_accountA | Returns one loyalty account in full: balance, every tracked property (elite status, account number, points to next level, ...), sub-accounts such as individual cards, links to update it on AwardWallet, and its transaction history, paginated. |
| get_travel_timelineA | Lists trips from AwardWallet's travel timeline (flights, hotels, car rentals, trains, buses, cruises, ferries, transfers, parking and events) with dates, confirmation numbers, travelers and locations, sorted by start date, for a date window (default: today through 12 months ahead). Only connected users who share trips are covered, and AwardWallet requires a paid Business subscription with timeline export approval. |
| search_loyalty_programsA | Searches the loyalty programs AwardWallet supports by name or code (e.g. 'hyatt', 'avios', 'membership rewards'), optionally by type. Returns program codes for get_loyalty_program. |
| get_loyalty_programA | Returns what AwardWallet knows about one loyalty program: its login fields, the properties it tracks (elite status, expiration, ...), how many elite levels it has, and what AwardWallet can do with it (transaction history, itineraries, reservation lookup, expiration tracking). |
| search_api_operationsA | Searches the raw AwardWallet API operations this server can call, across the Account Access, Web Parsing (Loyalty), Email Parsing, Credit Card Bonus, Flight Award Search and Hotel Award Search APIs (https://awardwallet.com/api/main). Returns each match's id, whether it reads or writes, its documentation link and the JSON Schema of its input. An empty query lists every available operation briefly. |
| call_api_read_operationA | Runs a read-only AwardWallet API operation (access=read in search_api_operations) and returns AwardWallet's JSON response. Refuses write operations. API reference: https://awardwallet.com/api/main. |
| call_api_write_operationA | Runs an AwardWallet API operation that creates, changes or deletes data, signs in to a loyalty or mailbox account, or starts billable work (access=write in search_api_operations). When it needs a password or token, it returns a one-time link to a local page where the user types it, so the secret never passes through the conversation. API reference: https://awardwallet.com/api/main. |
| get_secure_input_resultA | Returns the status of a request waiting on the secure input page (waiting, completed, failed, cancelled or expired) and, once completed, AwardWallet's response. |
| connect_awardwalletA | Connects this server to the user's AwardWallet account. Returns a one-time link to a page on this computer where the user pastes their AwardWallet API key (from https://business.awardwallet.com/profile/api), or a paid API's username and password. The page checks it with AwardWallet and saves it on this computer; it never passes through the conversation, so never ask the user to type a key in the chat. Use it when get_status or another tool reports a missing or rejected key, or when the user wants to change it. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Each tool has a distinct resource+action: high-level CRUD-style tools (list/get/search) are clearly separated from generic API operation tools and from authentication/status tools. No two tools appear to do the same thing.
All names use snake_case with a consistent verb_noun pattern (get_, list_, search_, call_, connect_), applied uniformly across all 12 tools.
12 tools is well within the ideal 3-15 range and each tool maps to a necessary capability, including both convenience wrappers and raw API access.
The set covers authentication/status, people, loyalty programs, loyalty accounts, travel timeline, and provides a generic gateway (search_api_operations plus call_api_read/write) to the full AwardWallet API, so no dead ends remain.