FIRMSapi

com.firmsapi/mcpVersion 1.0.0

Look up, search and validate U.S. CBP FIRMS facility codes for piers, CFS, warehouses and FTZs.

Status

Responds385 msNov 14, 2026, 13:56 UTCAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.

Last checked: Nov 14, 2026, 13:56 UTC
Latency: 385 ms
Remotes responding: 1 of 1
Sign-in: API key
Hosting: Hosted outside the EU (detected)
Registry data as of: Nov 14, 2026, 21:12 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP

https://api.firmsapi.com/mcpResponds385 msNov 14, 2026, 13:56 UTC

No sign-in

Claude Code

claude mcp add --transport http firmsapi https://api.firmsapi.com/mcp --header 'x-api-key: <YOUR_X_API_KEY>'

Replace <YOUR_X_API_KEY> before running.

Claude Desktop and claude.ai

Settings > Connectors > Add custom connector
Name: firmsapi
Remote MCP server URL: https://api.firmsapi.com/mcp
This server expects the header x-api-key.

Cursor

{
  "mcpServers": {
    "firmsapi": {
      "url": "https://api.firmsapi.com/mcp",
      "headers": {
        "x-api-key": "<YOUR_X_API_KEY>"
      }
    }
  }
}

Replace <YOUR_X_API_KEY> before running.

VS Code

code --add-mcp '{"name":"firmsapi","type":"http","url":"https://api.firmsapi.com/mcp","headers":{"x-api-key":"<YOUR_X_API_KEY>"}}'

Replace <YOUR_X_API_KEY> before running.

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

6 tools

Tools of FIRMSapi
	Description		Read-only	Idempotent	Open world
`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.	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.	No	Yes	Yes	No
`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.	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.	No	Yes	Yes	No
`list_cbp_ports`List every CBP port that has FIRMS codes, with name, state, region, facility_count and active_count, in one call.	List every CBP port that has FIRMS codes, with name, state, region, facility_count and active_count, in one call.	No	Yes	Yes	No
`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.	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.	No	Yes	Yes	No
`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.	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.	No	Yes	Yes	No
`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.	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.	No	Yes	Yes	No

Details

Registry status: Active
Published: Oct 26, 2026
Updated: Oct 26, 2026
Website: https://docs.firmsapi.com/mcp/⁠ (opens in a new tab)
Repository: Not given
Categories (suggested): Search and webSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR: Not declared

Are you the operator? Claim this listing