bots.st/firmsapi
FIRMSapi
CBP FIRMS code lookup and validation
2898 ms
answered our call
- State
- Answered
- Protocol
- MCP 2025-06-18
- Tools listed
- 6
- Answered
- 3 of the last 3 calls
How to reach it
- MCP, HTTP
https://api.firmsapi.com/mcpNeeds header x-api-key
What it can do
| Tool | What it says it does |
|---|---|
find_nearby_firms_facilities | List FIRMS facilities within radius_km, nearest first. Pass exactly one origin: lat and lon; code (another FIRMS facility, left out of the results); or address (a US street address, geocoded unless it is a FIRMS facility's own address). meta.origin says which point was used. Facilities whose… |
get_cbp_port | One CBP port with a page of its FIRMS facilities, ordered by code. Placeholders are left out; active codes only unless include_deleted is true. For the next page pass cursor = meta.next_cursor (null on the last page); each page is one call. Wraps GET /v1/ports/{port}. Live keys (fapi_live_...)… |
list_cbp_ports | Every CBP port that has FIRMS codes, with name, state, region, facility_count and active_count, in one call. Wraps GET /v1/ports. Live keys (fapi_live_...): one counted call. Test keys (fapi_test_...): fixture sample data, not counted. |
lookup_firms_code | Get the CBP FIRMS record for one code: facility name, status (active or deleted), facility type, address, CBP port, location, and the other codes registered at the same address. Deleted codes and "DO NOT USE" placeholders (junk: true) are returned with warnings. A code that is not on the list… |
search_firms_facilities | Find FIRMS codes from a facility name and/or street address, e.g. 'maher terminal elizabeth' or '231 tyler st newark'. Typo-tolerant; returns ranked matches with a 0-100 score. Active codes only unless include_deleted is true. One call per search, however many results. Wraps GET /v1/search. Live… |
validate_firms_code | Pre-filing checks of a FIRMS code against the published CBP list, in order: format, exists (catches ACE reject 158), active (159), in the stated port (164), facility type fits the use (warehouse_entry: bonded warehouse 04; ftz_admission: FTZ 02; exam_site: CES 09; location_of_goods: not 07 or 08)… |
In its maker's words
Look up, search and validate U.S. CBP FIRMS facility codes for piers, CFS, warehouses and FTZs.
- Website
- docs.firmsapi.com/mcp
- Publisher
- firmsapi.com
- Listed from
- the official MCP Registry as
com.firmsapi/mcp - Version
- 1.0.0, updated 26 Oct 2026
- Kinds of work
- Search and research, Law, tax and government, Security and trust
The domain it lives on
- firmsapi.com
- registered 23 Oct 2026 (1 month ago), at Cloudflare, 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 | 2898 ms | |
| Answered | 3320 ms | |
| Answered | 1492 ms |
Next door
Is this your bot? Claim its address to add a verified badge and keep the listing current.