bots.st/allowances-api
Allowances API
Fetch per diem and allowance rates
2611 ms
answered our call
- State
- Answered
- Protocol
- MCP 2025-06-18
- Tools listed
- 43
- Answered
- 3 of the last 3 calls
How to reach it
- MCP, HTTP
https://mcp.allowancesapi.com/mcpNeeds header X-API-Key
What it can do
| Tool | What it says it does |
|---|---|
calculate_mileage_reimbursement | 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… |
calculate_trip_per_diem | 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… |
cola_calculator_by_postcode | 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 | 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` limits the result to some allowances. For one post… |
get_allowances_by_location | 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 | 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_city_pair_locations | 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+… |
get_city_pairs | 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… |
get_countries | 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. |
get_country | 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. |
get_destination_by_id | 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. |
get_destinations | 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… |
get_dssr_locations | 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 | 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. |
get_dtmo_conus_locations | 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… |
get_dtmo_oconus_locations | 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_conus | 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… |
get_dtmo_perdiem_oconus | 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)… |
get_fema_hotel_by_id | 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… |
get_fema_hotels_by_state_city | 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… |
get_fema_hotels_by_zipcode | 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… |
get_fleet_rates_by_sin | 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… |
get_gsa_fedrooms | 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… |
get_gsa_perdiem_by_destination | 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_state | 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… |
get_gsa_perdiem_by_state_year | 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… |
get_gsa_perdiem_by_zipcode | 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… |
get_gsa_perdiem_by_zipcode_year | 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… |
get_latest_publications | 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… |
get_mie_breakdowns | 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… |
get_mileage | 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. |
get_opm_localities | 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… |
get_opm_locality_by_county | 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… |
get_opm_pay | 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. |
get_perdiem_allowance | 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… |
get_perdiem_allowance_by_location | 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… |
get_perdiem_allowance_by_postcode | 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… |
get_user | 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. |
get_zipcode | 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. |
search_dtmo_perdiem | 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… |
search_fema_hotels | 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`… |
search_opm_pay | 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… |
search_perdiem | 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… |
In its maker's words
U.S. government per diem and overseas allowance rates from GSA, DTMO OCONUS and State DSSR tables.
- Website
- www.allowancesapi.com/mcp-server
- Publisher
- allowancesapi.com
- Listed from
- the official MCP Registry as
com.allowancesapi/per-diem-allowances - Version
- 1.0.0, updated 1 Nov 2026
- Kinds of work
- Finance and markets, Law, tax and government, Search and research
The domain it lives on
- allowancesapi.com
- registered 31 Jan 2026 (9 months ago), at NameCheap, Inc., its home page is a working site
From our own crawl of domain names: registry records and the home page as our crawler last saw it.
Every call we made
| When | What happened | Time |
|---|---|---|
| Answered | 2611 ms | |
| Answered | 2840 ms | |
| Answered | 1031 ms |
Next door
- gblin-treasury-risk-regimeUSDC treasury risk and NAV actions
- Agent402.Tools: pay-per-call web toolsUS equity quotes and live news/search
- Financial Modeling Prep MCP ServerAccess financial data tools from an API
- TokenZeroVerifiable AI spend receipts and waste audits
- savvlyEligibility checks, projections, product comparisons
Is this your bot? Claim its address to add a verified badge and keep the listing current.