Allowances API
Server Details
U.S. government per diem and overseas allowance rates from GSA, DTMO OCONUS and State DSSR tables.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 43 tools
The set covers several distinct allowance sources (DSSR, DTMO, GSA, FEMA, OPM), but within each source there are many near-parallel tools such as get_allowances vs get_allowances_by_location vs get_allowances_by_postcode, and get_gsa_perdiem_by_zipcode vs get_gsa_perdiem_by_zipcode_year. Descriptions explicitly disambiguate lookup keys and use cases, but an agent still has to choose among many similar variants.
Nearly all tools use snake_case with a predictable verb_noun or get_noun pattern, including get_, calculate_, and search_ prefixes. The main deviation is cola_calculator_by_postcode, which uses a noun-first 'calculator' style while the parallel tool is calculate_trip_per_diem.
43 tools is well above the typical 3-15 range and the set contains many parallel lookup variants for the same underlying data sources. While the breadth reflects multiple allowance datasets, the count feels heavy and increases selection burden.
The surface covers a wide range of federal travel allowance domains: DSSR, DTMO, GSA per diem, FEMA lodging, OPM pay, mileage, city pairs, fleet rates, M&IE breakdowns, and metadata such as publications and account usage. Minor gaps exist, such as no obvious destination-ID-based fiscal-year GSA per diem tool parallel to the state and ZIP year variants.
Available Tools
43 toolscalculate_mileage_reimbursementMileage reimbursement calculatorARead-onlyIdempotentInspect
Calculate mileage reimbursement with the official GSA rate in effect on the travel date (today if omitted). Provide a distance in miles and the vehicle type: automobile, airplane, motorcycle or moving. For automobile travel, say whether a government-furnished automobile was available, which selects the reduced rate. Returns the rate category, rate and effective date, and the amount rounded to the cent. Use get_mileage for the rates alone.
Inputs: distance (required), vehicle_type (required), date, government_vehicle_available.
calculate_trip_per_diemGSA trip per diem calculatorARead-onlyIdempotentInspect
Estimates GSA CONUS per diem for a multi-stop trip: a day-by-day breakdown and totals of payable lodging and M&IE. Each stop has inclusive arrival and departure dates and a GSA destination ID or ZIP code, optionally the actual nightly lodging cost and meals to deduct. Applies the rate in effect each day, 75% M&IE on first and last days, the official meal deductions and the lodging cap (excess reported as overage). Not for Department of Defense or foreign travel.
Inputs: stops (required), deductible_meals, verification_url.
cola_calculator_by_postcodeDSSR COLA calculatorARead-onlyIdempotentInspect
Calculates the DSSR cost-of-living allowance (COLA) for a post: the COLA rate in percent and the annual and biweekly USD amounts for the given base salary and family size, today or on date. The post is identified by its five-digit DSSR post code (see get_dssr_locations_by_country). Use get_allowances for the COLA rate alone. History starts on 2008-01-01.
Inputs: postcode (required), base_salary (required), family_size (required), date.
get_allowancesDSSR allowances by countryARead-onlyIdempotentInspect
Returns State Department (DSSR) allowance rates for every post in a country: cost-of-living (COLA),
hardship differential, living quarters (LQA), danger pay and education allowances, plus each post's per
diem, in force today or on date. type selects which allowances. For one post use
get_allowances_by_location or get_allowances_by_postcode; for DoD rates use the DTMO tools.
Posts the State Department removed return no allowances after their last listing. History starts on 2008-01-01.
Inputs: country_iso_code (required), date, type, verification_url.
get_allowances_by_locationDSSR allowances by location nameARead-onlyIdempotentInspect
Returns DSSR allowances (COLA, hardship, LQA, danger pay, education, per diem) for one post in a country
matched by name, case-insensitive and partial ('toky' finds Tokyo), today or on date. Find exact post
names with get_dssr_locations_by_country or search_perdiem. Use get_allowances_by_postcode when the DSSR
post code is known, get_allowances for every post in the country.
Posts the State Department removed return no allowances after their last listing. History starts on 2008-01-01.
Inputs: location (required), country_iso_code (required), date, type, +1 more.
get_allowances_by_postcodeDSSR allowances by location post codeARead-onlyIdempotentInspect
Returns DSSR allowances (COLA, hardship, LQA, danger pay, education, per diem) for the post identified by
its five-digit DSSR post code, today or on date. Post codes are the State Department's own identifiers
and come back in every DSSR result, so this is the most precise lookup. Use get_allowances_by_location
for a name, get_allowances for the whole country.
Posts the State Department removed return no allowances after their last listing. History starts on 2008-01-01.
Inputs: postcode (required), country_iso_code (required), date, type, +1 more.
get_city_pair_locationsCity Pair airport and city codesARead-onlyIdempotentInspect
Returns the airport or metropolitan codes GSA uses in City Pair airfare awards for the fiscal year of date (today by default), with city, state and country. GSA decides whether a city uses airport codes (DCA, IAD) or a metro code (WAS), so resolve codes here before get_city_pairs. q (3+ characters) matches a code exactly or a city or country name by substring. Fiscal years other than the current one depend on the plan.
Inputs: q, date.
get_city_pairsCity Pair contract airfaresARead-onlyIdempotentInspect
Returns GSA City Pair Program contract airfares between two codes (see get_city_pair_locations) on date, today by default: every matching award with airline, service and one-way USD fares by category (YCA, CA, business and others; null means not offered), valid in either direction. Government contract prices, not live availability; domestic fares exclude passenger and security fees. Other fiscal years depend on the plan; there is no fallback to another date.
Inputs: origin (required), destination (required), date, verification_url.
get_countriesFind country code and postsARead-onlyIdempotentInspect
Resolves a country name to its ISO alpha-2 code and lists the names of its DSSR posts; q matches the
country name case-insensitively ('papua' finds PG). Use it before any tool that needs a country code. ZZ
stands for Other Foreign Localities, not a country. Returns no rates.
Inputs: q, limit, offset.
get_countryCountry by ISO codeARead-onlyIdempotentInspect
Returns one country by ISO alpha-2 code: its name, the names of its DSSR posts and State Department notes. Use get_countries to find the code from a name, and get_dssr_locations_by_country when the post codes are needed too. Returns no rates.
Inputs: country_iso_code (required).
get_destination_by_idGet GSA destination metadata by IDARead-onlyIdempotentInspect
Returns the metadata of one GSA destination rate area by numeric ID: GSA's display name, the defined geographic scope, county and state. ID 0 is the Standard CONUS area. No rates: use get_gsa_perdiem_by_destination for the rate on a date and get_destinations to browse IDs.
Inputs: destination_id (required).
get_destinationsList GSA destinationsARead-onlyIdempotentInspect
Returns the paginated list of every GSA destination rate area with its numeric ID, display name, defined scope, county and state, ordered by ID (offset, limit; past the end is an empty list). Use the ID with get_gsa_perdiem_by_destination or calculate_trip_per_diem. No rates; a ZIP or state lookup is usually faster than browsing.
Inputs: limit, offset.
get_dssr_locationsList DSSR postsARead-onlyIdempotentInspect
Returns a paginated list of every DSSR post with its country, ISO code and post name; q filters by
case-insensitive substring. total counts every match regardless of offset and limit. Use it to find
the exact post name for the by-location tools when the country is unknown; get_dssr_locations_by_country
is shorter when it is known. Returns no rates.
Inputs: q, limit, offset.
get_dssr_locations_by_countryDSSR posts in a countryARead-onlyIdempotentInspect
Returns the DSSR posts of a country by ISO alpha-2 code, each with its name and five-digit post code
(external_id), as needed by the by-location and by-postcode tools. Use get_countries to resolve a name
to the code. Returns no rates.
Inputs: country_iso_code (required).
get_dtmo_conus_locationsDTMO CONUS locations by stateARead-onlyIdempotentInspect
Returns the DTMO per diem locations of a US state (US-XX code) with location name and county, as named in
the Department of Defense CONUS table. Use it to find the name for the q filter of
get_dtmo_perdiem_conus. Returns no rates. For other countries, Alaska, Hawaii and territories use
get_dtmo_oconus_locations.
Inputs: state_iso (required).
get_dtmo_oconus_locationsDTMO OCONUS locations by countryARead-onlyIdempotentInspect
Returns the DTMO per diem locations of a country by ISO alpha-2 code ('AU', 'BE'), as named in the
Department of Defense OCONUS table. location filters by case-insensitive substring, taken literally (no
wildcards); no match returns an empty list. Use the names for the q filter of get_dtmo_perdiem_oconus.
Returns no rates.
Inputs: country_iso_code (required), location.
get_dtmo_perdiem_conusDTMO CONUS per diem by stateARead-onlyIdempotentInspect
Department of Defense per diem for the continental U.S. by state code (e.g. 'TX'); Alaska, Hawaii
and the territories are served by the OCONUS endpoint. Returns lodging, local and proportional meal
rates, incidentals and the maximum per diem (lodging + meals + incidentals) per season. q filters by
location name. date selects the rates in force on that day, year a fiscal year (Oct 1 to Sep 30);
omit both for the current fiscal year.
Inputs: state_iso (required), q, date, year, +3 more.
get_dtmo_perdiem_oconusDTMO OCONUS per diem by countryARead-onlyIdempotentInspect
Department of Defense per diem outside the continental U.S.: foreign countries by ISO alpha-2 code
(e.g. 'PG'), and Alaska, Hawaii and U.S. territories by 'US-XX' code. Returns lodging, local and
proportional meal rates, incidentals and the maximum per diem (lodging + meals + incidentals) per
season. q filters by location name. date selects the rates in force on that day, year a fiscal
year (Oct 1 to Sep 30); omit both for the current fiscal year.
Inputs: oconus_iso_code (required), q, date, year, +3 more.
get_fema_hotel_by_idFEMA-listed property by FEMA IDARead-onlyIdempotentInspect
Returns one property on FEMA's Hotel and Motel National Master List by FEMA ID, or a 404 error when the ID is not listed: name, address, phone, property type, stories and sprinklers, with as_of the date of the list snapshot. Use it to confirm a hotel is fire-safe for reimbursed federal lodging. No rates.
Inputs: fema_id (required).
get_fema_hotels_by_state_cityFEMA-listed hotels by state and cityARead-onlyIdempotentInspect
Returns the properties on FEMA's Hotel and Motel National Master List in a US state, optionally narrowed by a partial, case-insensitive city ('york' matches New York and Yorktown), ordered by city then name and paginated with offset, limit (up to 200) and total. Covers the 50 states, DC and the territories FEMA lists. Returns FEMA ID, address and property details, no rates.
Inputs: state_iso (required), city, limit, offset.
get_fema_hotels_by_zipcodeFEMA-listed properties by ZIP codeARead-onlyIdempotentInspect
Returns every property on FEMA's Hotel and Motel National Master List in a US ZIP code (five digits or ZIP+4), ordered by name, with FEMA ID, address and property details. A known ZIP with no listed property returns an empty list, an unknown ZIP a 404 error. Fire-safe lodging is required for reimbursed federal travel; no rates, pair with get_gsa_perdiem_by_zipcode.
Inputs: zipcode (required).
get_fleet_rates_by_sinGSA Fleet leasing ratesARead-onlyIdempotentInspect
Returns the GSA Fleet vehicle leasing rates (monthly lease rate and rate per mile) for the vehicle type identified by its Standard Item Number (SIN), from the standard (US) or europe rate schedule, for the current fiscal year unless year is given; rates are available from fiscal year 2022. SINs are the vehicle-type codes of the GSA Fleet rate schedule; the response names the vehicle type.
Inputs: sin (required), rate_type (required), year, verification_url.
get_gsa_fedroomsList worldwide FedRooms propertiesARead-onlyIdempotentInspect
Lists current worldwide FedRooms hotels with name, address, postal city, state, postal code and country. Optional q matches every word as a case-insensitive literal substring across those fields. country filters by ISO alpha-2 code; results include country_iso_code. Paginate with offset and limit (maximum 200); total counts matches. as_of is the UTC download date. verification_url always links to GSA. No prices or availability; book through approved channels for the FedRooms rate.
Inputs: q, limit, offset, country.
get_gsa_perdiem_by_destinationGSA per diem rate by destinationARead-onlyIdempotentInspect
Returns the GSA per diem of one GSA destination rate area (a city, county, metro area or the Standard CONUS area, ID 0) in effect today or on date: the seasonal lodging rate and daily M&IE in USD. Destination IDs come from get_destinations or any GSA per diem result. When the ID is unknown use get_gsa_perdiem_by_zipcode or get_gsa_perdiem_by_state.
Inputs: destination_id (required), date, verification_url.
get_gsa_perdiem_by_stateGSA per diem rates by state and dateARead-onlyIdempotentInspect
Returns every GSA destination rate in a US state (US-XX) in effect today or on date: seasonal lodging and daily M&IE in USD per destination, with its county. location filters by destination or defined-area name, case-insensitive and partial. A state with no non-standard destination returns the Standard CONUS rate. CONUS only: for Alaska, Hawaii, territories and abroad use the DTMO or DSSR tools.
Inputs: state_iso (required), date, location, verification_url.
get_gsa_perdiem_by_state_yearGSA per diem rates by state and fiscal yearARead-onlyIdempotentInspect
Return every GSA destination rate in a US state (US-XX) for a US fiscal year (October 1 to September 30): the lodging rate for every month and the daily M&IE rate per destination. The optional location filters destinations by GSA destination or defined-area name, case-insensitive and partial. Set verification_url=true to include the official GSA state lookup URL. Use get_gsa_perdiem_by_state for the rate on one date.
Inputs: year (required), state_iso (required), location, verification_url.
get_gsa_perdiem_by_zipcodeGSA per diem rates by ZIP code and dateARead-onlyIdempotentInspect
Returns the GSA per diem for a US ZIP code (five digits or ZIP+4) in effect today or on date: seasonal lodging and daily M&IE in USD. A ZIP can map to several destinations; then every rate is returned with its county and none is chosen for you. A ZIP with no non-standard destination returns the Standard CONUS rate. Use get_gsa_perdiem_by_zipcode_year for a whole fiscal year.
Inputs: zipcode (required), date, verification_url.
get_gsa_perdiem_by_zipcode_yearGSA per diem rates by ZIP code and fiscal yearARead-onlyIdempotentInspect
Returns the GSA lodging rate for every month of a US fiscal year (October 1 to September 30) and the daily M&IE, in USD, for a US ZIP code (five digits or ZIP+4). A ZIP can map to several destinations; then every rate is returned with its county and none is chosen for you. A ZIP with no non-standard destination returns the Standard CONUS rate. Use get_gsa_perdiem_by_zipcode for the rate on one date.
Inputs: year (required), zipcode (required), verification_url.
get_latest_publicationsLatest data publicationsARead-onlyIdempotentInspect
Returns the most recent data loaded for each source, with its publication date and fiscal year: DSSR allowances and per diem, DTMO CONUS and OCONUS per diem, GSA per diem, mileage, vehicle rates and M&IE breakdowns, FEMA hotels and OPM pay tables. Use it to say how current an answer is. Returns no rates.
Inputs: no named parameters.
get_mie_breakdownsM&IE meal breakdownsARead-onlyIdempotentInspect
Return how daily M&IE totals break down into breakfast, lunch, dinner and incidental expenses, as in effect on the given date. The CONUS table breaks down the five standard CONUS M&IE tiers and is returned by default. Set region=oconus for the generic DTMO/DSSR M&IE total table. If date is not specified, today's breakdowns will be returned.
Inputs: date, total, region, verification_url.
get_mileagePOV mileage ratesARead-onlyIdempotentInspect
Returns the GSA privately owned vehicle (POV) mileage reimbursement rates in USD per mile for airplane, automobile, government-furnished automobile, motorcycle and moving, in effect today or on date; type selects one. Use calculate_mileage_reimbursement to turn a distance into an amount.
Inputs: date, type, verification_url.
get_opm_localitiesGS locality pay areasARead-onlyIdempotentInspect
Returns OPM General Schedule locality pay areas for the latest pay year with the code for get_opm_pay. location keeps areas whose name contains every word and areas of counties or cities with exactly that name (state narrows it); matched_places shows why. A place in no area returns Rest of U.S. (RUS); several areas come back when a name exists in several states or a city spans areas. Empty results mean an unknown name, not RUS. Territories are not covered.
Inputs: state, location.
get_opm_locality_by_countyGS locality pay area of a countyARead-onlyIdempotentInspect
Returns the General Schedule locality pay area of a county by five-digit FIPS code for the latest pay year, with the code for get_opm_pay. Counties outside every area return Rest of U.S. (RUS); every county in Alaska or Hawaii returns that state's area. Unknown codes, Connecticut planning regions and territory counties are 404 errors. Use get_opm_localities to search by name.
Inputs: fips (required).
get_opm_payGS pay by locality codeARead-onlyIdempotentInspect
Return the latest pay table of a locality pay area, ordered by grade and step, or 404 for an unknown code. grade and step narrow the rates. Use GS for the base table without locality pay, and RUS for Rest of U.S.
Inputs: locality_code (required), step, grade.
get_perdiem_allowanceDSSR per diem by countryARead-onlyIdempotentInspect
Returns State Department (DSSR) per diem for every post in a country: lodging, M&IE and maximum per diem
in USD per day, today or on date. For one post use get_perdiem_allowance_by_location or
get_perdiem_allowance_by_postcode; for a place name without a country code use search_perdiem. For
Department of Defense travel use get_dtmo_perdiem_oconus.
Inputs: country_iso_code (required), date, verification_url.
get_perdiem_allowance_by_locationDSSR per diem by location nameARead-onlyIdempotentInspect
Returns DSSR per diem (lodging, M&IE and maximum per diem in USD per day) for one post in a country
matched by name, case-insensitive and partial, today or on date. Find exact post names with
get_dssr_locations_by_country or search_perdiem. Use get_perdiem_allowance for the whole country,
get_perdiem_allowance_by_postcode for a known post code.
Inputs: location (required), country_iso_code (required), date, verification_url.
get_perdiem_allowance_by_postcodeDSSR per diem by location post codeARead-onlyIdempotentInspect
Returns DSSR per diem (lodging, M&IE and maximum per diem in USD per day) for the post identified by its
five-digit DSSR post code, today or on date. Every DSSR result carries the post code, so use it for
follow-up lookups. Use get_perdiem_allowance_by_location for a name, get_perdiem_allowance for the whole
country.
Inputs: postcode (required), country_iso_code (required), date, verification_url.
get_userAccount plan and quotaARead-onlyIdempotentInspect
Returns the account behind the API key: plan, monthly request limit, requests used in the current billing period, and the period start, end and renewal date. Use it to explain a quota or plan error or to check remaining requests. This call does not count against the quota.
Inputs: no named parameters.
get_zipcodeZIP code metadataARead-onlyIdempotentInspect
Returns the state or states a US ZIP code (five digits or ZIP+4) belongs to; a ZIP that crosses a state line returns every state. Metadata only, no rates: use get_gsa_perdiem_by_zipcode for per diem. Send ZIPs as strings so leading zeros survive.
Inputs: zipcode (required).
search_dtmo_perdiemSearch DTMO per diem by nameARead-onlyIdempotentInspect
Finds Department of Defense per diem by location name ('Kabul') or country or state name ('Afghanistan'),
across CONUS and OCONUS, with no code needed. Returns lodging, local and proportional meal rates,
incidentals and maximum per diem per matching location and season. date selects the rates in force on
that day, year a fiscal year (Oct 1 to Sep 30); omit both for the current fiscal year.
Inputs: q, date, year, verification_url.
search_fema_hotelsSearch FEMA-listed properties by name and townARead-onlyIdempotentInspect
Searches FEMA's Hotel and Motel National Master List (fire-safe lodging, required for reimbursed federal travel) by property name and city: every word of q must appear as a plain substring of the name or city, with no fuzzy matching. state narrows to one state; paginated with offset, limit (up to 200) and total. Returns FEMA ID, address, phone and property details, no rates: pair with GSA per diem for the lodging cap.
Inputs: q (required), limit, state, offset.
search_opm_paySearch GS pay by locality areaARead-onlyIdempotentInspect
Return the latest General Schedule pay tables whose locality area matches every word of q: each word must be contained in the area name, case-insensitively, or equal its code. grade and step narrow the rates; no match returns an empty results list. Matching only looks at OPM's area names, not the counties and towns they cover, so a town missing from the names returns nothing, which does not mean Rest of U.S. Use get_opm_localities to resolve a place to its area.
Inputs: q (required), step, grade.
search_perdiemSearch DSSR per diem by nameARead-onlyIdempotentInspect
Finds DSSR per diem by a partial, case-insensitive country or post name of at least three characters,
with no country code needed. Returns lodging, M&IE and maximum per diem per matching post, today or on
date, with the post code for precise follow-up lookups. A name that matches nothing is a 404 error, not
an empty list. Once the ISO code is known, the country tools are more precise.
Inputs: q (required), date.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
GSA Per Diem access readiness, lodging, and meals and incidental expense rates. 7 tools.
Unofficial GSA Per Diem MCP — wraps the GSA Per Diem API v2 (api.gsa.gov)
Compliant per diems in one call: official US GSA, German BMF and UK HMRC rates, with a trip…
Travel allowances from bundled Polish, HMRC and GSA rate tables, with partial days and meals.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables querying GSA Per Diem rates for travel destinations, providing daily lodging and meal allowance data from the U.S. General Services Administration API.272 npmMIT
- AlicenseAqualityCmaintenanceEnables an AI assistant to retrieve official IRS vehicle-mileage rates and GSA/IRS travel per diem rates by date or ZIP code, and to calculate mileage deductions and trip allowances with the correct rate for each date.5MIT
- AlicenseNot gradedqualityDmaintenanceProvides access to Swedish per diem (traktamente) rates from Skatteverket's official API, enabling queries by country, year, or country code for international travel expense calculations.8 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables querying GSA CALC+ ceiling labor rates, including individual vendor rates, summary statistics, and filtering by experience, education, worksite, business size, clearance, and rate ranges.74 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.