Official MCP RegistryListed
FIRMSapi
Look up, search and validate U.S. CBP FIRMS facility codes for piers, CFS, warehouses and FTZs.
First seen 26 Oct 2026. Evidence as of 11 Nov 2026.
6
Tools
From an anonymous probe
1
Source listings
Each with its own history
17
Recorded changes
Since first seen
Tools
| Tool | Description | Behaviour |
|---|---|---|
| find_nearby_firms_facilities | List FIRMS facilities within radius_km of one origin, nearest first. Pass exactly one origin: lat and lon, code (that facility is left out of the results) or address (a US street address). meta.origin says which point was used. Facilities without coordinates are left out; test keys use approximate ones. | Read-only |
| get_cbp_port | Get one CBP port and a page of its FIRMS facilities, ordered by code, without placeholders; 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. | Read-only |
| list_cbp_ports | List every CBP port that has FIRMS codes, with name, state, region, facility_count and active_count, in one call. | Read-only |
| lookup_firms_code | Get one FIRMS code's record: facility name, status, type, address, CBP port, location and the other codes at the same address. Deleted codes and placeholders (junk: true) come back with warnings. An unknown code is a not_found error, which still counts as a call. | Read-only |
| search_firms_facilities | Search FIRMS codes by facility name and/or street address. Typo-tolerant; returns matches ranked by a 0-100 score, active codes only unless include_deleted is true. One call per search. | Read-only |
| validate_firms_code | Check a FIRMS code against the published CBP list before filing, in order: format, exists (ACE reject 158), active (159), in the stated port (164), type fits the use, not a placeholder. Returns valid, checks_passed, checks_failed, checks_skipped and checks_not_possible (bond status, FTZ zone ID, direct delivery, port clusters). valid: true is not ACE acceptance: confirm in ACE before filing. valid: false is a normal answer and counts as a call. | Read-only |
Change history
- validate_firms_code: input schema changed
- validate_firms_code: description changed (+"Check" +"list before filing," +"(ACE")
- search_firms_facilities: input schema changed
- search_firms_facilities: description changed (+"Search" +"by" +"address.")
- lookup_firms_code: input schema changed
- lookup_firms_code: description changed (+"one" +"code's record:" +"status,")
- list_cbp_ports: input schema changed
- list_cbp_ports: description changed (+"List every" -"Every" -"Wraps GET /v1/ports. Live keys (fapi_live_...): one counted call. Test keys (fapi_test_...): fixture sample data, not counted.")
- get_cbp_port: input schema changed
- get_cbp_port: description changed (+"Get one" +"and" +"code, without placeholders;")
- find_nearby_firms_facilities: input schema changed
- find_nearby_firms_facilities: description changed (+"radius_km of one origin," +"lon," +"(that facility is")
- server instructions changed (+"codes (4-character" +"sites)" +"list, dated by meta.data_as_of.")
- search_firms_facilities: input schema changed
- get_cbp_port: input schema changed
- find_nearby_firms_facilities: input schema changed
- Listed (registry)
| Source | Listing | First seen | Last seen | Versions |
|---|---|---|---|---|
| Official MCP Registry | com.firmsapi/mcp | 26 Oct 2026 | 10 Nov 2026 | 1 |