FIRMSapi

Working · 3.4 s

com.firmsapi/mcpv1.0.0 Domain verified

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

Legal & Government

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.firmsapi.com/mcp

x-api-key (required)

FIRMSapi API key from https://app.firmsapi.com. fapi_test_ keys return fixture data and are never counted; fapi_live_ keys count toward your plan.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

find_nearby_firms_facilities Read-only

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 could not be geocoded are not included. Test keys use approximate coordinates. Wraps GET /v1/nearby. Live keys (fapi_live_...): one counted call. Test keys (fapi_test_...): fixture sample data, not counted.

latnumber

lonnumber

codestring

Search around this FIRMS code.

limitinteger

typesarray

Only these facility types: 01 Container freight station (CFS), 02 Foreign trade zone (FTZ), 03 Pier or terminal, 04 Bonded warehouse, 05 Inspection facility, 06 Importer premises, 07 DP site, 08 CBP administrative, 09 Centralized examination station (CES), 10 Rail or air terminal (inferred), 11 CBP test.

addressstring

Search around this US street address, e.g. 231 Tyler St, Newark, NJ 07114.

radius_kmnumber

include_deletedboolean

Include deleted codes (ranked after active ones).

Try it

Call this server's tools from your browser. Nothing to install.

https://api.firmsapi.com/mcp

x-api-key (required)

FIRMSapi API key from https://app.firmsapi.com. fapi_test_ keys return fixture data and are never counted; fapi_live_ keys count toward your plan.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

find_nearby_firms_facilities Read-only

latnumber

lonnumber

codestring

Search around this FIRMS code.

limitinteger

typesarray

addressstring

Search around this US street address, e.g. 231 Tyler St, Newark, NJ 07114.

radius_kmnumber

include_deletedboolean

Include deleted codes (ranked after active ones).

Tools (6)

find_nearby_firms_facilities

read-only

Argument	Type	Description
lat	number
lon	number
code	string	Search around this FIRMS code.
limit	integer
types	array	Only these facility types: 01 Container freight station (CFS), 02 Foreign trade zone (FTZ), 03 Pier or terminal, 04 Bonded warehouse, 05 Inspection facility, 06 Importer premises, 07 DP site, 08 CBP administrative, 09 Centralized examination station (CES), 10 Rail or air terminal (inferred), 11 CBP test.
address	string	Search around this US street address, e.g. 231 Tyler St, Newark, NJ 07114.
radius_km	number
include_deleted	boolean	Include deleted codes (ranked after active ones).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "lon": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "code": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{4}$",
      "description": "Search around this FIRMS code."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "types": {
      "type": "array",
      "items": {
        "enum": [
          "01",
          "02",
          "03",
          "04",
          "05",
          "06",
          "07",
          "08",
          "09",
          "10",
          "11"
        ],
        "type": "string"
      },
      "description": "Only these facility types: 01 Container freight station (CFS), 02 Foreign trade zone (FTZ), 03 Pier or terminal, 04 Bonded warehouse, 05 Inspection facility, 06 Importer premises, 07 DP site, 08 CBP administrative, 09 Centralized examination station (CES), 10 Rail or air terminal (inferred), 11 CBP test."
    },
    "address": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3,
      "description": "Search around this US street address, e.g. 231 Tyler St, Newark, NJ 07114."
    },
    "radius_km": {
      "type": "number",
      "default": 10,
      "maximum": 100,
      "exclusiveMinimum": 0
    },
    "include_deleted": {
      "type": "boolean",
      "default": false,
      "description": "Include deleted codes (ranked after active ones)."
    }
  },
  "additionalProperties": false
}

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 counted call. Test keys (fapi_test_...): fixture sample data, not counted.

read-only

Argument	Type	Description
port*	string	4-digit CBP port code, e.g. 4601.
limit	integer
types	array	Only these facility types: 01 Container freight station (CFS), 02 Foreign trade zone (FTZ), 03 Pier or terminal, 04 Bonded warehouse, 05 Inspection facility, 06 Importer premises, 07 DP site, 08 CBP administrative, 09 Centralized examination station (CES), 10 Rail or air terminal (inferred), 11 CBP test.
cursor	string	meta.next_cursor.
include_deleted	boolean	Include deleted codes (ranked after active ones).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "port"
  ],
  "properties": {
    "port": {
      "type": "string",
      "pattern": "^[0-9]{4}$",
      "description": "4-digit CBP port code, e.g. 4601."
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "types": {
      "type": "array",
      "items": {
        "enum": [
          "01",
          "02",
          "03",
          "04",
          "05",
          "06",
          "07",
          "08",
          "09",
          "10",
          "11"
        ],
        "type": "string"
      },
      "description": "Only these facility types: 01 Container freight station (CFS), 02 Foreign trade zone (FTZ), 03 Pier or terminal, 04 Bonded warehouse, 05 Inspection facility, 06 Importer premises, 07 DP site, 08 CBP administrative, 09 Centralized examination station (CES), 10 Rail or air terminal (inferred), 11 CBP test."
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{4}$",
      "description": "meta.next_cursor."
    },
    "include_deleted": {
      "type": "boolean",
      "default": false,
      "description": "Include deleted codes (ranked after active ones)."
    }
  },
  "additionalProperties": false
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

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 returns a not_found error, which still counts as a call. Wraps GET /v1/firms/{code}. Live keys (fapi_live_...): one counted call. Test keys (fapi_test_...): fixture sample data, not counted.

read-only

Argument	Type	Description
code*	string	4-character FIRMS code, e.g. E430.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{4}$",
      "description": "4-character FIRMS code, e.g. E430."
    }
  },
  "additionalProperties": false
}

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 keys (fapi_live_...): one counted call. Test keys (fapi_test_...): fixture sample data, not counted.

read-only

Argument	Type	Description
port	string	4-digit CBP port code, e.g. 4601.
limit	integer
query*	string	Name and/or address.
state	string	2-letter state, e.g. NJ.
types	array	Only these facility types: 01 Container freight station (CFS), 02 Foreign trade zone (FTZ), 03 Pier or terminal, 04 Bonded warehouse, 05 Inspection facility, 06 Importer premises, 07 DP site, 08 CBP administrative, 09 Centralized examination station (CES), 10 Rail or air terminal (inferred), 11 CBP test.
include_deleted	boolean	Include deleted codes (ranked after active ones).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "port": {
      "type": "string",
      "pattern": "^[0-9]{4}$",
      "description": "4-digit CBP port code, e.g. 4601."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "Name and/or address."
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "2-letter state, e.g. NJ."
    },
    "types": {
      "type": "array",
      "items": {
        "enum": [
          "01",
          "02",
          "03",
          "04",
          "05",
          "06",
          "07",
          "08",
          "09",
          "10",
          "11"
        ],
        "type": "string"
      },
      "description": "Only these facility types: 01 Container freight station (CFS), 02 Foreign trade zone (FTZ), 03 Pier or terminal, 04 Bonded warehouse, 05 Inspection facility, 06 Importer premises, 07 DP site, 08 CBP administrative, 09 Centralized examination station (CES), 10 Rail or air terminal (inferred), 11 CBP test."
    },
    "include_deleted": {
      "type": "boolean",
      "default": false,
      "description": "Include deleted codes (ranked after active ones)."
    }
  },
  "additionalProperties": false
}

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), not a placeholder. Returns valid, checks_passed, checks_failed, checks_skipped, checks_not_possible (bond status, FTZ zone ID, direct delivery, port clusters: not in the FIRMS list) and a note. valid: true is not ACE acceptance: FIRMSapi has no ACE connection, so confirm in ACE before filing. A failing code is a normal result (valid: false) and counts as a call. Wraps POST /v1/validate. Live keys (fapi_live_...): one counted call. Test keys (fapi_test_...): fixture sample data, not counted.

read-only

Argument	Type	Description
use	string	How the code will be used; enables the facility type check.
code*	string	The code as it appears in your system. A malformed code is a failed check.
port	string	4-digit CBP port of entry of the filing.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "use": {
      "enum": [
        "warehouse_entry",
        "ftz_admission",
        "exam_site",
        "location_of_goods"
      ],
      "type": "string",
      "description": "How the code will be used; enables the facility type check."
    },
    "code": {
      "type": "string",
      "maxLength": 32,
      "minLength": 1,
      "description": "The code as it appears in your system. A malformed code is a failed check."
    },
    "port": {
      "type": "string",
      "maxLength": 8,
      "description": "4-digit CBP port of entry of the filing."
    }
  },
  "additionalProperties": false
}