How to Use the AwardWallet MCP in OpenAI Agents SDK

Q: What kind of loyalty programs does this support?

Your agent can get a full, up-to-date list by calling the listloyaltyproviders tool. This gives you the exact names and codes for every supported airline, hotel, and rental car program.

Q: Can I use the OpenAI Agents SDK to check a user's AwardWallet points history?

Yes. The agent will use the getuseraccounts tool to find the right account ID, then call getaccounthistory to pull the full transaction log. The SDK's tracing makes it easy to follow this two-step process.

Build production agents that manage travel rewards with AwardWallet and the OpenAI Agents SDK. Guardrails included.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AwardWallet MCP to OpenAI Agents SDK

Create your Vinkius account to connect AwardWallet to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup AwardWallet with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage User Loyalty Accounts

The `list_connected_users` tool gives your agent a roster of everyone who's authorized your app. From there, you can pull a specific user's full loyalty account list using `get_user_accounts`. This is perfect for building an agent that answers, "show me all of John Doe's connected airline accounts." The OpenAI SDK's built-in tracing lets you see every step of the agent's logic in your dashboard, so you can debug exactly how it found the answer.

Track Trips and History with an MCP Server

Let your agent pull travel plans and point balances. The `get_user_itineraries` tool fetches upcoming trips, while `get_user_timeline` provides a chronological view of a user's travel activity. You can also dig into a specific loyalty program with `get_account_history`. An agent built with the OpenAI Agents SDK can use these tools to proactively alert a user about an upcoming flight or a change in their points balance. The SDK's guardrails can prevent the agent from pulling history for the wrong account by adding a confirmation step before execution.

Connect and Check Account Status

The `create_auth_url` tool is your starting point, generating a unique link for each user to connect their AwardWallet account. Once they're connected, `get_account_check` acts as a simple ping to confirm your API connection is live and healthy. This isn't just about connecting. It's about building a reliable system. Your agent can use `get_account_check` as a health check before attempting more complex operations, and the SDK's handoff features mean a specialized "connectivity agent" could manage this process for your AwardWallet MCP Server.

Setup guide

Set up AwardWallet MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all AwardWallet tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives AwardWallet tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate AwardWallet tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="AwardWallet Agent",
            instructions="You have access to AwardWallet tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by AwardWallet. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect AwardWallet now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about AwardWallet MCP in OpenAI Agents SDK

Just pass the AwardWallet MCP Server to your agent on initialization, and it will auto-discover the `get_user_itineraries` tool. Then you can prompt it, "Show me my upcoming trips from AwardWallet."

Your agent can get a full, up-to-date list by calling the `list_loyalty_providers` tool. This gives you the exact names and codes for every supported airline, hotel, and rental car program.

Yes. The agent will use the `get_user_accounts` tool to find the right account ID, then call `get_account_history` to pull the full transaction log. The SDK's tracing makes it easy to follow this two-step process.

Not at all. You just provide the Vinkius endpoint URL when you create the `MCPServerStreamableHttp` object. The agent framework handles the rest of the tool discovery automatically.

This MCP server only accesses the specific AwardWallet data your agent requests, like itineraries and account point balances. All data is transmitted over encrypted connections, and Vinkius runs each server in an ephemeral, zero-trust sandbox.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript