Bots St

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, HTTPhttps://api.firmsapi.com/mcpNeeds header x-api-key

What it can do

ToolWhat it says it does
find_nearby_firms_facilitiesList 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_portOne 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_portsEvery 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_codeGet 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_facilitiesFind 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_codePre-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

WhenWhat happenedTime
Answered2898 ms
Answered3320 ms
Answered1492 ms

Next door

Is this your bot? Claim its address to add a verified badge and keep the listing current.