Skip to main content
Glama
bbarabe

AwardWallet MCP

by bbarabe

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
AW_API_KEYNoAccount Access API key.
AW_MOCK_MODENoBuilt-in demo data; nothing is sent to AwardWallet.false
AW_READ_ONLYNoRegister read-only tools only.false
AW_API_KEY_FILENoPath to a file containing the Account Access API key.
AW_CONNECT_LINKSNoOffer create_connection_link.false
AW_EMAIL_API_REGIONNoeu keeps Email Parsing data in AwardWallet's EU infrastructure.us
AW_SECURE_INPUT_URLNoPublic base URL of that page when tunneled.
AW_SECURE_INPUT_PORTNoFixed port for the secure input page.
AW_CC_BONUS_CREDENTIALSNoCredit Card Bonus API credentials in the form username:password.
AW_CONNECT_REDIRECT_URLNoNeeded only if your business has several Redirect URLs configured.
AW_WEB_PARSING_CREDENTIALSNoWeb Parsing (Loyalty) API credentials in the form username:password.
AW_HOTEL_SEARCH_CREDENTIALSNoHotel Award Search API credentials in the form username:password.
AW_CC_BONUS_CREDENTIALS_FILENoPath to a file containing the Credit Card Bonus API credentials in the form username:password.
AW_EMAIL_PARSING_CREDENTIALSNoEmail Parsing API credentials in the form username:password.
AW_FLIGHT_SEARCH_CREDENTIALSNoFlight Award Search API credentials in the form username:password.
AW_WEB_PARSING_CREDENTIALS_FILENoPath to a file containing the Web Parsing (Loyalty) API credentials in the form username:password.
AW_HOTEL_SEARCH_CREDENTIALS_FILENoPath to a file containing the Hotel Award Search API credentials in the form username:password.
AW_EMAIL_PARSING_CREDENTIALS_FILENoPath to a file containing the Email Parsing API credentials in the form username:password.
AW_FLIGHT_SEARCH_CREDENTIALS_FILENoPath 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.2/5.0

Scored across 12 tools

Disambiguation5/5

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.

Naming Consistency5/5

All names use snake_case with a consistent verb_noun pattern (get_, list_, search_, call_, connect_), applied uniformly across all 12 tools.

Tool Count5/5

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.

Completeness5/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo issues