FIRMSapi is an MCP server published by com.firmsapi, hosted at api.firmsapi.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 6 tools, including lookup_firms_code, search_firms_facilities, find_nearby_firms_facilities, validate_firms_code, list_cbp_ports.
Look up, search and validate U.S. CBP FIRMS facility codes for piers, CFS, warehouses and FTZs.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| code * | string | 4-character FIRMS code. |
{
"name": "lookup_firms_code",
"title": "Look up a FIRMS code",
"description": "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.",
"inputSchema": {
"type": "object",
"examples": [
{
"code": "E430"
}
],
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"pattern": "^[A-Za-z0-9]{4}$",
"description": "4-character FIRMS code."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Look up a FIRMS code",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
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.
| Parameter | Type | Description |
|---|---|---|
| port | string | 4-digit CBP port code. |
| limit | integer | Most matches to return. |
| query * | string | Facility name and/or street address. |
| state | string | 2-letter state. |
| types | array | Only these facility types: 01 CFS, 02 FTZ, 03 pier/terminal, 04 bonded warehouse, 05 inspection facility, 06 importer premises, 07 DP site, 08 CBP admin, 09 CES, 10 rail/air terminal, 11 CBP test. |
| include_deleted | boolean | Include deleted codes, ranked after active ones. |
{
"name": "search_firms_facilities",
"title": "Search facilities by name or address",
"description": "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.",
"inputSchema": {
"type": "object",
"examples": [
{
"query": "maher terminal elizabeth",
"state": "NJ"
}
],
"required": [
"query"
],
"properties": {
"port": {
"type": "string",
"pattern": "^[0-9]{4}$",
"description": "4-digit CBP port code."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Most matches to return."
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "Facility name and/or street address."
},
"state": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "2-letter state."
},
"types": {
"type": "array",
"items": {
"enum": [
"01",
"02",
"03",
"04",
"05",
"06",
"07",
"08",
"09",
"10",
"11"
],
"type": "string"
},
"description": "Only these facility types: 01 CFS, 02 FTZ, 03 pier/terminal, 04 bonded warehouse, 05 inspection facility, 06 importer premises, 07 DP site, 08 CBP admin, 09 CES, 10 rail/air terminal, 11 CBP test."
},
"include_deleted": {
"type": "boolean",
"default": false,
"description": "Include deleted codes, ranked after active ones."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search facilities by name or address",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| lat | number | Origin latitude; pass with lon. |
| lon | number | Origin longitude; pass with lat. |
| code | string | Origin FIRMS code. |
| limit | integer | Most facilities to return. |
| types | array | Only these facility types: 01 CFS, 02 FTZ, 03 pier/terminal, 04 bonded warehouse, 05 inspection facility, 06 importer premises, 07 DP site, 08 CBP admin, 09 CES, 10 rail/air terminal, 11 CBP test. |
| address | string | Origin US street address. |
| radius_km | number | Search radius in km. |
| include_deleted | boolean | Include deleted codes, ranked after active ones. |
{
"name": "find_nearby_firms_facilities",
"title": "Find facilities near a point, code or address",
"description": "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.",
"inputSchema": {
"type": "object",
"examples": [
{
"code": "E430",
"radius_km": 5
}
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Origin latitude; pass with lon."
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Origin longitude; pass with lat."
},
"code": {
"type": "string",
"pattern": "^[A-Za-z0-9]{4}$",
"description": "Origin FIRMS code."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Most facilities to return."
},
"types": {
"type": "array",
"items": {
"enum": [
"01",
"02",
"03",
"04",
"05",
"06",
"07",
"08",
"09",
"10",
"11"
],
"type": "string"
},
"description": "Only these facility types: 01 CFS, 02 FTZ, 03 pier/terminal, 04 bonded warehouse, 05 inspection facility, 06 importer premises, 07 DP site, 08 CBP admin, 09 CES, 10 rail/air terminal, 11 CBP test."
},
"address": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Origin US street address."
},
"radius_km": {
"type": "number",
"default": 10,
"maximum": 100,
"description": "Search radius in km.",
"exclusiveMinimum": 0
},
"include_deleted": {
"type": "boolean",
"default": false,
"description": "Include deleted codes, ranked after active ones."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Find facilities near a point, code or address",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| use | string | Intended use, for the type check: warehouse_entry needs type 04, ftz_admission 02, exam_site 09; location_of_goods excludes 07 and 08. |
| code * | string | The code as it appears in your system; a malformed code fails the format check. |
| port | string | 4-digit CBP port of entry of the filing. |
{
"name": "validate_firms_code",
"title": "Check a FIRMS code before filing",
"description": "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.",
"inputSchema": {
"type": "object",
"examples": [
{
"use": "location_of_goods",
"code": "E430",
"port": "4601"
}
],
"required": [
"code"
],
"properties": {
"use": {
"enum": [
"warehouse_entry",
"ftz_admission",
"exam_site",
"location_of_goods"
],
"type": "string",
"description": "Intended use, for the type check: warehouse_entry needs type 04, ftz_admission 02, exam_site 09; location_of_goods excludes 07 and 08."
},
"code": {
"type": "string",
"maxLength": 32,
"minLength": 1,
"description": "The code as it appears in your system; a malformed code fails the format check."
},
"port": {
"type": "string",
"maxLength": 8,
"description": "4-digit CBP port of entry of the filing."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Check a FIRMS code before filing",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List every CBP port that has FIRMS codes, with name, state, region, facility_count and active_count, in one call.
No parameters.
{
"name": "list_cbp_ports",
"title": "List CBP ports",
"description": "List every CBP port that has FIRMS codes, with name, state, region, facility_count and active_count, in one call.",
"inputSchema": {
"type": "object",
"examples": [
{}
],
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List CBP ports",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| port * | string | 4-digit CBP port code. |
| limit | integer | Facilities per page. |
| types | array | Only these facility types: 01 CFS, 02 FTZ, 03 pier/terminal, 04 bonded warehouse, 05 inspection facility, 06 importer premises, 07 DP site, 08 CBP admin, 09 CES, 10 rail/air terminal, 11 CBP test. |
| cursor | string | meta.next_cursor from the previous page. |
| include_deleted | boolean | Include deleted codes, ranked after active ones. |
{
"name": "get_cbp_port",
"title": "Get a CBP port and its facilities",
"description": "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.",
"inputSchema": {
"type": "object",
"examples": [
{
"port": "4601",
"types": [
"03"
]
}
],
"required": [
"port"
],
"properties": {
"port": {
"type": "string",
"pattern": "^[0-9]{4}$",
"description": "4-digit CBP port code."
},
"limit": {
"type": "integer",
"default": 100,
"maximum": 100,
"minimum": 1,
"description": "Facilities per page."
},
"types": {
"type": "array",
"items": {
"enum": [
"01",
"02",
"03",
"04",
"05",
"06",
"07",
"08",
"09",
"10",
"11"
],
"type": "string"
},
"description": "Only these facility types: 01 CFS, 02 FTZ, 03 pier/terminal, 04 bonded warehouse, 05 inspection facility, 06 importer premises, 07 DP site, 08 CBP admin, 09 CES, 10 rail/air terminal, 11 CBP test."
},
"cursor": {
"type": "string",
"pattern": "^[A-Za-z0-9]{4}$",
"description": "meta.next_cursor from the previous page."
},
"include_deleted": {
"type": "boolean",
"default": false,
"description": "Include deleted codes, ranked after active ones."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get a CBP port and its facilities",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}FIRMSapi answers questions about U.S. CBP FIRMS codes (4-character codes for piers, container freight stations, bonded warehouses, foreign trade zones and exam sites) from the published CBP list, dated by meta.data_as_of. Each tool call is one API call on the key's monthly plan; invalid arguments, auth errors, quota_exceeded and server errors are not counted. Test keys (fapi_test_...) return a small fixture sample, are never counted and must not be used for filing. FIRMSapi has no connection to ACE: a passing validation is not ACE acceptance, so tell the user to confirm the code, bond status and port eligibility in ACE. Webhooks and change notifications are not available. About a third of codes are not a letter plus three digits: never reject a code for its shape.
Names, descriptions and schemas were written by the server and are shown as data.