{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "api.firmsapi.com",
    "site": "firmsapi.com",
    "addresses": [
      {
        "address": "50.16.248.47",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 16509,
          "name": "AMAZON-02 - Amazon.com, Inc.",
          "prefix": "50.16.0.0/14",
          "country": "US"
        }
      },
      {
        "address": "98.91.71.197",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 14618,
          "name": "AMAZON-AES - Amazon.com, Inc.",
          "prefix": "98.88.0.0/13",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "50.16.248.47",
          "98.91.71.197"
        ],
        "first_seen": "2026-11-22T14:32:02.848Z",
        "last_seen": "2026-11-22T14:32:02.848Z",
        "checks": 1
      }
    ],
    "hosting": [],
    "software": [],
    "server_info": {
      "name": "firmsapi",
      "version": "1.0.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "strict-transport-security": "max-age=31536000; includeSubDomains",
      "access-control-allow-origin": "*"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "com.firmsapi",
      "total": 0,
      "sample": []
    },
    "same_repository": null,
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "9828",
    "server_name": "com.firmsapi/mcp",
    "url": "https://api.firmsapi.com/mcp",
    "host": "api.firmsapi.com",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T14:32:02.848Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "dab543b5331894e56e4a5b0cabaa245ab4d665b4b818a89054ccc68e16736fbe",
    "first_listed_at": "2026-11-21T08:28:01.683Z",
    "created_at": "2026-11-21T05:45:12.013Z",
    "resolved_addresses": [
      "50.16.248.47",
      "98.91.71.197"
    ]
  },
  "server": {
    "name": "com.firmsapi/mcp",
    "title": "FIRMSapi",
    "description": "Look up, search and validate U.S. CBP FIRMS facility codes for piers, CFS, warehouses and FTZs.",
    "version": "1.0.0",
    "registry_status": "active",
    "repository_url": null,
    "website_url": "https://docs.firmsapi.com/mcp/",
    "published_at": "2026-10-26T01:51:37.894Z",
    "updated_at": "2026-10-26T01:51:37.894Z",
    "first_seen": "2026-11-21T05:45:11.391Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:10:12.188Z"
  },
  "operator": {
    "key": "firmsapi.com",
    "name": "firmsapi.com",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 280,
    "first_check_in_window": "2026-11-21T08:28:01.683Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "dab543b5331894e56e4a5b0cabaa245ab4d665b4b818a89054ccc68e16736fbe",
    "tools": 6,
    "resources": 0,
    "prompts": 0,
    "first_seen": "2026-11-21T08:28:01.969Z",
    "tool_names": [
      "lookup_firms_code",
      "search_firms_facilities",
      "find_nearby_firms_facilities",
      "validate_firms_code",
      "list_cbp_ports",
      "get_cbp_port"
    ],
    "declared": {
      "tools": [
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": []
    },
    "instructions": "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."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}