How to Use the GSA Per Diem Rates MCP in OpenAI Agents SDK

Q: Can my agent handle state-wide travel queries using GSA Per Diem Rates in OpenAI Agents SDK?

Yes, the agent calls getratesbystate to pull rates for every county and city in a target state. This allows your OpenAI Agents SDK setup to calculate complex multi-city itineraries without needing separate queries for each stop.

Q: How do I search for rates by city name using GSA Per Diem Rates with OpenAI Agents SDK?

Your agent uses the getratesbycity tool, passing the city name and state abbreviation. The OpenAI Agents SDK processes this request and returns the exact lodging and meal limits for that specific municipality.

Pull official federal lodging and meal rates directly into your OpenAI Agents SDK workflow with zero manual data entry.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GSA Per Diem Rates MCP to OpenAI Agents SDK

Create your Vinkius account to connect GSA Per Diem Rates 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 GSA Per Diem Rates with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Verify official travel limits inside OpenAI Agents SDK.

The `get_rates_by_zip` tool pulls official GSA lodging and meal rates directly into your agent's execution loop. Your agent queries this endpoint with a zip code to instantly find the allowable federal limits for any destination. This eliminates manual lookups and prevents employees from booking rooms that exceed federal caps. The SDK uses its built-in guardrails to check these values before approving travel requests. By combining this MCP Server with your agent's decision-making flow, you ensure that every planned trip conforms to strict government spending guidelines automatically.

Calculate meal breakdowns for audit compliance.

The `get_mie_breakdown` tool extracts breakfast, lunch, and dinner allocations for any specific fiscal year. Your agent uses this breakdown to audit line-item expense reports, flagging any meal claims that exceed the official daily allowance. This process runs entirely within your agentic workflow, using OpenAI's tracing dashboard to monitor every API call. You get a clear audit trail showing exactly how the agent validated each meal expense against the official GSA database.

Map high-volume ZIP codes without rate limits.

The `get_zip_mapping` tool resolves geographic zip codes to their corresponding GSA destination identifiers in bulk. Running this MCP tool speeds up batch processing when your agent needs to evaluate hundreds of travel requests simultaneously. Instead of making repetitive, slow queries, the agent pulls the mapping first and then uses `get_conus_lodging` to fetch standard continental US rates. This keeps your pipeline fast and avoids hitting external API limits during peak expense-reporting cycles.

Setup guide

Set up GSA Per Diem Rates 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 GSA Per Diem Rates tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate GSA Per Diem Rates 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="GSA Per Diem Rates Agent",
            instructions="You have access to GSA Per Diem Rates 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 GSA. 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 GSA Per Diem Rates 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 GSA Per Diem Rates MCP in OpenAI Agents SDK

You register the server by passing its streamable HTTP URL to the agent constructor. The OpenAI Agents SDK automatically discovers all six MCP tools, making them instantly available for your agent to call. This setup takes less than ten lines of Python code.

Yes, the agent calls `get_rates_by_state` to pull rates for every county and city in a target state. This allows your OpenAI Agents SDK setup to calculate complex multi-city itineraries without needing separate queries for each stop.

Your agent uses the `get_rates_by_city` tool, passing the city name and state abbreviation. The OpenAI Agents SDK processes this request and returns the exact lodging and meal limits for that specific municipality.

The MCP Server returns an error or empty result, which your agent catches. You can configure a fallback step where the agent prompts the user for the city name and uses `get_rates_by_city` instead.

All geographic queries and rate lookups run in an isolated V8 sandbox on Vinkius. The server only handles ZIP codes, city names, and state abbreviations, meaning no personally identifiable employee information or sensitive corporate travel plans ever leave your secure environment.

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