mcpbeat Sign in

FIRMSapi MCP Server

by firmsapi Your server? Claim it
answering

FIRMSapi is answering right now. Last checked 1 min ago. It exposes 6 tools.

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

Uptime history 7 days of history
7 days agonow
100.0%
Uptime 24h
92 of 92 checks
6
Tools
read from the server
508 ms
Response time
average over 24h
open, no key
Access
streamable-http

What changed 3

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 30 October 2026. No other catalogue keeps this.

30 Oct 3 tools changed the parameters they ask for find_nearby_firms_facilities, get_cbp_port, search_firms_facilities

Nothing serious here today

Today is the operative word: we check FIRMSapi every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Three servers free · no card

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 1 min ago.

run in your terminal
claude mcp add mcp --transport http https://api.firmsapi.com/mcp
Settings → Connectors → Add custom connector, then paste this address
https://api.firmsapi.com/mcp
~/.codex/config.toml
[mcp_servers.mcp]
url = "https://api.firmsapi.com/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.firmsapi.com/mcp"
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.firmsapi.com/mcp"
    }
  }
}

Available tools 6

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

cbp
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.
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.
firms
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.
lookup
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.
nearby
find_nearby_firms_facilities
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.
validate
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.

Endpoints

URLTransportStateLatencyChecked
https://api.firmsapi.com/mcp streamable-http answering 453 ms 1 min ago

Alternatives to FIRMSapi

same job, measured the same way
Ibangen MCP
by offx366

Validate IBANs, generate test IBANs with real bank codes, look up BICs and bank codes (IBANgen).

388 installs/wk 5 tools answering
Vexor
by scarletkc

A semantic search engine for files and code.

671 installs/wk local only
Icd10 MCP
by mrfentmen

Search and validate ICD-10-CM diagnosis codes from the US NLM clinical tables - keyless.

466 installs/wk local only
Pine Script v6 Documentation
by paulieb89

Pine Script v6 documentation lookup, function validation, and linting for AI code generation

306 installs/wk 10 tools answering
Modelbound MCP
by modelbound

Local-first MCP server for agent skills. Validate, lint, diff, and convert across IDEs.

57 installs/wk local only
Metricui
by mpmcgowen

React dashboard components — API lookup, code generation, and prop validation for AI tools.

39 installs/wk local only
Icf MCP
by stayce

WHO ICF codes: lookup, search, hierarchy, qualifiers, and 11 scored clinical assessment instruments.

1 tools answering
Icd MCP
by stayce

WHO ICD-10/ICD-11 diagnosis codes. Lookup, search, chapters via official WHO API.

1 tools answering

FIRMSapi — questions

Answers built from our own checks of this server.

What can FIRMSapi do?
It exposes 6 tools, read directly from the server on our last check. Among them: find_nearby_firms_facilities, get_cbp_port, list_cbp_ports, lookup_firms_code, search_firms_facilities, validate_firms_code. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is FIRMSapi working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 508 ms. The bar chart above shows every period we have measured.
How do I connect FIRMSapi?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does FIRMSapi need an API key?
No. FIRMSapi completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 6 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is FIRMSapi?
It answers our handshake in 508 ms on average, which is faster than 24% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.