com.firmsapi/mcp · v1.0.0 · developer-tools
FIRMSapi is healthy: it completed an MCP handshake in 1426 ms and exposes 6 tools.
Look up, search and validate U.S. CBP FIRMS facility codes for piers, CFS, warehouses and FTZs.
Endpoint: https://api.firmsapi.com/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 6 |
| Latency | 1426 ms |
| Last checked (UTC) | 2026-10-26T06:00:15.601Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-26T06:00:15.601Z | Healthy | 1426 | |
| 2026-10-26T06:00:15.398Z | Healthy | 1358 |
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 return |
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 key |
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 address |
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), n |
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. |
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_...): one |