• Repository

Meta

• License: MIT License (MIT)
• Author: James Jenrette / 1102tools
• Tags 1102 , federal-contracts , gsa , lodging , mcp , mie , model-context-protocol , per-diem , travel
• Requires: Python >=3.10

Classifiers

• Development Status
  • 3 - Alpha
• Intended Audience
  • Developers
• License
  • OSI Approved :: MIT License
• Programming Language
  • Python :: 3

gsa-perdiem-mcp

MCP server for the GSA Per Diem Rates API. Federal travel lodging and M&IE rates for IGCEs and travel cost estimation.

Works without configuration using DEMO_KEY. Optional free API key for higher rate limits.

Tested and hardened through six rounds of integration testing against the live GSA Per Diem API, including a round-6 live audit with a real api.data.gov key. 413 regression tests covering 1 P0 path-traversal bug, 23 P1 silent-wrong-data bugs, and 21 P2 validation gaps fixed. See TESTING.md for the full testing record.

What it does

Exposes the GSA Per Diem API as 6 MCP tools:

Core lookups

• lookup_city_perdiem - Rates by city/state (auto-selects best NSA match)
• lookup_zip_perdiem - Rates by ZIP code
• lookup_state_rates - All NSA rates for a state
• get_mie_breakdown - M&IE tier table (meal components)

Workflow

• estimate_travel_cost - Calculate trip per diem (lodging + M&IE with first/last day at 75%)
• compare_locations - Compare rates across multiple cities

Get your own API key (strongly recommended)

This server hits api.gsa.gov, which uses api.data.gov for rate limiting.

• Without a key: falls back to the shared DEMO_KEY which is capped at ~10 requests per hour across everyone using it. A couple real prompts will blow through that limit and you'll start seeing 429 errors.
• With a personal key: 1,000 requests per hour, yours alone.

Get a free key (takes 30 seconds):

1. Go to api.data.gov/signup
2. Enter your name and email — no approval, no wait
3. Copy the key from the confirmation page
4. Paste it into your Claude Desktop config as PERDIEM_API_KEY (see below)

The same key works for every api.data.gov-backed API (GSA Per Diem, NASA, FEC, FCC, etc.).

Installation

uvxgsa-perdiem-mcp

Claude Desktop configuration

Recommended (with your own key):

{
"mcpServers":{
"gsa-perdiem":{
"command":"uvx",
"args":["gsa-perdiem-mcp"],
"env":{
"PERDIEM_API_KEY":"paste-your-api-data-gov-key-here"
}
}
}
}

Without a key (works for a handful of calls per hour, then 429s until the hour rolls over):

{
"mcpServers":{
"gsa-perdiem":{
"command":"uvx",
"args":["gsa-perdiem-mcp"]
}
}
}

Example prompts

• "What's the per diem rate for Washington DC in FY2026?"
• "Estimate travel costs for 4 nights in Boston in March."
• "Compare per diem rates for DC, New York, and San Francisco."
• "What are all the NSA per diem locations in Virginia?"
• "Show me the M&IE meal breakdown for the $92 tier."
• "Build a travel estimate: 3 trips to Seattle (4 nights each) and 2 trips to DC (3 nights each)."

Important: maximum reimbursement, not actual prices

Per diem rates are federal reimbursement ceilings per 41 CFR 301-11. They are not actual hotel prices. CONUS only. OCONUS rates are from the State Department. Lodging taxes generally not included. First/last travel day M&IE at 75%.

Companion tools

Use alongside bls-oews-mcp (wage data) and gsa-calc-mcp (ceiling rates) for complete IGCE development. Per diem covers the travel component; BLS and CALC+ cover labor.

License

MIT

Verified details

These details have been verified by PyPI

Project links

• Issues
• Repository

GitHub Statistics

Maintainers

👁 Avatar for 1102tools from gravatar.com
1102tools

Unverified details

These details have not been verified by PyPI

Project links

• Homepage

• Download URL: gsa_perdiem_mcp-0.2.6.tar.gz
• Upload date: Apr 25, 2026
• Size: 91.2 kB
• Tags: Source
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.13.12

Hashes for gsa_perdiem_mcp-0.2.6.tar.gz

Algorithm	Hash digest
SHA256	af349083b1d20ec92742714afa8a395f9a71a7860c837c07028b4c2a13963136
MD5	0c0767e7e001941156f779a6add41094
BLAKE2b-256	4b757a5ac11721edb4ccc1d39d85e962d0deeb93098bdb4726b414bc001fe285

See more details on using hashes here.

• Download URL: gsa_perdiem_mcp-0.2.6-py3-none-any.whl
• Upload date: Apr 25, 2026
• Size: 13.2 kB
• Tags: Python 3
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.13.12

Hashes for gsa_perdiem_mcp-0.2.6-py3-none-any.whl

Algorithm	Hash digest
SHA256	2a0b2c9f5485f384c3cf8d346cc7951b85c0e0d1031b18646f791f0e08cc233f
MD5	f3ea2235a0a39eef282b73c2322f0c13
BLAKE2b-256	fdb7e0e2c76714c0259f774f010675241c1ea4bda0c2f6da00f3e0a8c0d1940a

See more details on using hashes here.