{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_z7yfbechjqxv","handle":"firmsapi","url":"https://wellknown.network/agents/firmsapi","links":{"self":"https://wellknown.network/agents/firmsapi/record.json","html":"https://wellknown.network/agents/firmsapi","markdown":"https://wellknown.network/agents/firmsapi/record.md","api":"https://wellknown.network/api/v1/agents/firmsapi","status":"https://wellknown.network/api/v1/agents/firmsapi/status","claim":"https://wellknown.network/agents/firmsapi/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/firmsapi/claim.json","badge":"https://wellknown.network/agents/firmsapi/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/firmsapi/history","tools":"https://wellknown.network/api/v1/agents/firmsapi/tools"},"ard":{"identifier":"urn:air:api.firmsapi.com:server:firmsapi","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"FIRMSapi","summary":"Look up, search and validate U.S. CBP FIRMS facility codes for piers, CFS, warehouses and FTZs.","description":"Look up, search and validate U.S. CBP FIRMS facility codes for piers, CFS, warehouses and FTZs.","publisher":{"name":"com.firmsapi","url":null},"homepage":"https://docs.firmsapi.com/mcp/","repository":null,"version":"1.0.0","license":null,"protocols":["mcp"],"tags":[],"pricing":null,"endpoints":[{"url":"https://api.firmsapi.com/mcp","type":"mcp_streamable_http","auth":null,"probeable":true}],"skills":null,"tools":null,"extra":{"updatedAt":"2026-10-26T01:51:37.894453Z","publishedAt":"2026-10-26T01:51:37.894453Z","registryName":"com.firmsapi/mcp"},"attribution":{"kind":"mcp_registry","name":"mcp_registry","summary":"mcp_registry","version":"mcp_registry","description":"mcp_registry","homepageUrl":"mcp_registry","publisherName":"mcp_registry"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.525,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"live","statusReason":"Responded 3h ago.","lastOkAt":"2026-11-04T21:25:31.280Z","lastProbedAt":"2026-11-04T21:25:31.280Z","statusComputedAt":"2026-11-04T21:28:51.802Z","reliability30d":{"probes":23,"successRate":1,"p50Ms":194,"basis":"service","measures":{"availability":"availability","latency":"response time","tools":"tool surface observed","summary":"Checks reached the service itself."},"checks":{"total":23,"ok":23,"authBoundaryOk":0,"serviceOk":23,"note":"Counted from the observation rows for the window, checks of the server only (HTTP, A2A card, MCP initialize). ok = authBoundaryOk + serviceOk. `probes` is the sum of daily rollups and includes registry checks, so it can differ from `total`."}},"latestObservations":[{"at":"2026-11-04T21:25:31.280Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":158,"error":null,"detail":{"tools":[{"name":"lookup_firms_code","description":"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 "},{"name":"search_firms_facilities","description":"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 wit"},{"name":"find_nearby_firms_facilities","description":"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 "},{"name":"validate_firms_code","description":"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), fac"},{"name":"list_cbp_ports","description":"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"},{"name":"get_cbp_port","description":"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 pag"}],"toolCount":6,"toolsHash":"30516febffd21f7653bb6d4b547d1e60d15e66c90ae8cb73e69163dbb99aba61","serverName":"firmsapi","capabilities":["tools"],"serverVersion":"1.0.0","protocolVersion":"2025-06-18"}},{"at":"2026-11-04T12:23:47.998Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":150,"error":null,"detail":{"tools":[{"name":"lookup_firms_code","description":"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 "},{"name":"search_firms_facilities","description":"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 wit"},{"name":"find_nearby_firms_facilities","description":"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 "},{"name":"validate_firms_code","description":"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), fac"},{"name":"list_cbp_ports","description":"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"},{"name":"get_cbp_port","description":"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 pag"}],"toolCount":6,"toolsHash":"30516febffd21f7653bb6d4b547d1e60d15e66c90ae8cb73e69163dbb99aba61","serverName":"firmsapi","capabilities":["tools"],"serverVersion":"1.0.0","protocolVersion":"2025-06-18"}},{"at":"2026-11-04T04:27:44.595Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":122,"error":null,"detail":{"tools":[{"name":"lookup_firms_code","description":"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 "},{"name":"search_firms_facilities","description":"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 wit"},{"name":"find_nearby_firms_facilities","description":"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 "},{"name":"validate_firms_code","description":"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), fac"},{"name":"list_cbp_ports","description":"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"},{"name":"get_cbp_port","description":"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 pag"}],"toolCount":6,"toolsHash":"30516febffd21f7653bb6d4b547d1e60d15e66c90ae8cb73e69163dbb99aba61","serverName":"firmsapi","capabilities":["tools"],"serverVersion":"1.0.0","protocolVersion":"2025-06-18"}},{"at":"2026-11-03T20:32:56.362Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":148,"error":null,"detail":{"tools":[{"name":"lookup_firms_code","description":"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 "},{"name":"search_firms_facilities","description":"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 wit"},{"name":"find_nearby_firms_facilities","description":"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 "},{"name":"validate_firms_code","description":"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), fac"},{"name":"list_cbp_ports","description":"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"},{"name":"get_cbp_port","description":"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 pag"}],"toolCount":6,"toolsHash":"30516febffd21f7653bb6d4b547d1e60d15e66c90ae8cb73e69163dbb99aba61","serverName":"firmsapi","capabilities":["tools"],"serverVersion":"1.0.0","protocolVersion":"2025-06-18"}},{"at":"2026-11-03T12:33:09.775Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":150,"error":null,"detail":{"tools":[{"name":"lookup_firms_code","description":"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 "},{"name":"search_firms_facilities","description":"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 wit"},{"name":"find_nearby_firms_facilities","description":"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 "},{"name":"validate_firms_code","description":"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), fac"},{"name":"list_cbp_ports","description":"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"},{"name":"get_cbp_port","description":"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 pag"}],"toolCount":6,"toolsHash":"30516febffd21f7653bb6d4b547d1e60d15e66c90ae8cb73e69163dbb99aba61","serverName":"firmsapi","capabilities":["tools"],"serverVersion":"1.0.0","protocolVersion":"2025-06-18"}},{"at":"2026-11-03T04:27:46.492Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":167,"error":null,"detail":{"tools":[{"name":"lookup_firms_code","description":"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 "},{"name":"search_firms_facilities","description":"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 wit"},{"name":"find_nearby_firms_facilities","description":"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 "},{"name":"validate_firms_code","description":"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), fac"},{"name":"list_cbp_ports","description":"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"},{"name":"get_cbp_port","description":"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 pag"}],"toolCount":6,"toolsHash":"30516febffd21f7653bb6d4b547d1e60d15e66c90ae8cb73e69163dbb99aba61","serverName":"firmsapi","capabilities":["tools"],"serverVersion":"1.0.0","protocolVersion":"2025-06-18"}},{"at":"2026-11-02T20:31:34.451Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":135,"error":null,"detail":{"tools":[{"name":"lookup_firms_code","description":"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 "},{"name":"search_firms_facilities","description":"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 wit"},{"name":"find_nearby_firms_facilities","description":"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 "},{"name":"validate_firms_code","description":"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), fac"},{"name":"list_cbp_ports","description":"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"},{"name":"get_cbp_port","description":"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 pag"}],"toolCount":6,"toolsHash":"30516febffd21f7653bb6d4b547d1e60d15e66c90ae8cb73e69163dbb99aba61","serverName":"firmsapi","capabilities":["tools"],"serverVersion":"1.0.0","protocolVersion":"2025-06-18"}},{"at":"2026-11-02T12:24:05.233Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":150,"error":null,"detail":{"tools":[{"name":"lookup_firms_code","description":"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 "},{"name":"search_firms_facilities","description":"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 wit"},{"name":"find_nearby_firms_facilities","description":"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 "},{"name":"validate_firms_code","description":"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), fac"},{"name":"list_cbp_ports","description":"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"},{"name":"get_cbp_port","description":"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 pag"}],"toolCount":6,"toolsHash":"30516febffd21f7653bb6d4b547d1e60d15e66c90ae8cb73e69163dbb99aba61","serverName":"firmsapi","capabilities":["tools"],"serverVersion":"1.0.0","protocolVersion":"2025-06-18"}},{"at":"2026-11-02T04:21:19.530Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":132,"error":null,"detail":{"tools":[{"name":"lookup_firms_code","description":"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 "},{"name":"search_firms_facilities","description":"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 wit"},{"name":"find_nearby_firms_facilities","description":"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 "},{"name":"validate_firms_code","description":"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), fac"},{"name":"list_cbp_ports","description":"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"},{"name":"get_cbp_port","description":"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 pag"}],"toolCount":6,"toolsHash":"30516febffd21f7653bb6d4b547d1e60d15e66c90ae8cb73e69163dbb99aba61","serverName":"firmsapi","capabilities":["tools"],"serverVersion":"1.0.0","protocolVersion":"2025-06-18"}},{"at":"2026-11-01T19:22:51.734Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":1845,"error":null,"detail":{"tools":[{"name":"lookup_firms_code","description":"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 "},{"name":"search_firms_facilities","description":"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 wit"},{"name":"find_nearby_firms_facilities","description":"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 "},{"name":"validate_firms_code","description":"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), fac"},{"name":"list_cbp_ports","description":"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"},{"name":"get_cbp_port","description":"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 pag"}],"toolCount":6,"toolsHash":"30516febffd21f7653bb6d4b547d1e60d15e66c90ae8cb73e69163dbb99aba61","serverName":"firmsapi","capabilities":["tools"],"serverVersion":"1.0.0","protocolVersion":"2025-06-18"}}],"tools":[{"name":"lookup_firms_code","description":"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 "},{"name":"search_firms_facilities","description":"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 wit"},{"name":"find_nearby_firms_facilities","description":"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 "},{"name":"validate_firms_code","description":"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), fac"},{"name":"list_cbp_ports","description":"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"},{"name":"get_cbp_port","description":"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 pag"}],"package":null,"toolSurface":{"id":"ts_k3fv2tq97sva","endpointId":"ep_qnd532fnbzxm","hash":"30516febffd21f7653bb6d4b547d1e60d15e66c90ae8cb73e69163dbb99aba61","toolCount":6,"serverName":"firmsapi","serverVersion":"1.0.0","protocolVersion":"2025-06-18","firstSeenAt":"2026-10-30T04:25:08.241Z","lastSeenAt":"2026-11-04T21:25:31.281Z","observations":18,"toolNames":["lookup_firms_code","search_firms_facilities","find_nearby_firms_facilities","validate_firms_code","list_cbp_ports","get_cbp_port"],"distinctSurfaces":2},"endpointFacts":[{"id":"ep_qnd532fnbzxm","url":"https://api.firmsapi.com/mcp","type":"mcp_streamable_http","factsCheckedAt":"2026-11-02T04:21:19.533Z","auth":{"observedAt":"2026-11-02T04:21:19.621Z","authRequired":false,"scheme":null,"resourceMetadata":null,"authorizationServer":null,"conformance":{"dpop":false,"rfc8414":false,"rfc9728":false,"pkceS256":false,"clientIdMetadataDocument":false,"dynamicClientRegistration":false}},"tls":{"observedAt":"2026-11-02T04:21:19.792Z","protocol":"TLSv1.3","chainValid":true,"chainError":null,"hostMatches":true,"subject":"api.firmsapi.com","issuer":{"commonName":"Amazon RSA 2048 M01","organization":"Amazon"},"validFrom":"2026-10-25T00:00:00.000Z","validTo":"2027-05-10T23:59:59.000Z","daysToExpiry":186,"sanCount":1,"fingerprint256":"9B:93:60:78:18:A0:2D:41:4E:C1:39:79:95:F8:9B:0F:97:AB:CA:5B:58:B9:66:36:D2:57:39:BC:B2:90:5A:E3"}}]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"mcp_registry","key":"com.firmsapi/mcp","url":"https://registry.modelcontextprotocol.io/v0/servers/com.firmsapi%2Fmcp","firstSeenAt":"2026-10-28T13:20:05.965Z","fetchedAt":"2026-11-04T21:18:17.167Z","normalizedAt":"2026-11-04T21:18:17.167Z"}]},"firstSeenAt":"2026-10-28T13:20:05.965Z","updatedAt":"2026-11-04T21:30:17.364Z"}