Skip to content
MCP server

FIRMSapi

Look up, search and validate US CBP FIRMS facility codes for piers, warehouses and FTZs

Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About FIRMSapi

FIRMSapi is a freemium MCP server for freight and logistics. It runs as a hosted remote server, so there is nothing to install locally.

FIRMS codes identify the facilities where imported cargo can be held, and filers need the right one. This server wraps the FIRMSapi REST endpoints so an agent can fetch a code's record (name, status, type, address, port and the other codes at that address), search by facility name or address with typo tolerance and a 0 to 100 score, and find facilities near a point or street address.

validate_firms_code runs pre-filing checks for a port and intended use and reports checks passed, failed and not possible. The docs are clear about limits: FIRMSapi has no connection to ACE, a passing validation only means no check against the published CBP list failed, and bond status, FTZ zone ID and direct delivery cannot be confirmed from the list. Data is as fresh as the CBP list and every answer carries meta.data_as_of.

Authentication is your FIRMSapi key in an x-api-key header or as a bearer token. A fapi_test_ key returns fixture data and is never counted, while each live tool call counts exactly like the REST call it wraps. Batch, changes feed and watchlists stay REST-only.

Install

Run in a terminal

claude mcp add --transport http mcp https://api.firmsapi.com/mcp

Add to Settings → Connectors → Add custom connector

https://api.firmsapi.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://api.firmsapi.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.firmsapi.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://api.firmsapi.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://api.firmsapi.com/mcp"
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

lookup_firms_code
One code's record: name, status, type, address, port and other codes at the same address.
search_firms_facilities
Find codes from a facility name and/or address, typo-tolerant, with a 0-100 score.
find_nearby_firms_facilities
Facilities near a point, another FIRMS code or a US street address.
validate_firms_code
Pre-filing checks for a port and intended use.
list_cbp_ports
Every CBP port that has FIRMS codes, with counts.
get_cbp_port
One port and a page of its facilities.

What it does

Code lookup
Returns a code's status, type, address, port and co-located codes.
Fuzzy facility search
Finds codes from a name or address with a similarity score.
Nearby search
Facilities near a point, another FIRMS code or a US address.
Pre-filing validation
Reports checks passed, failed and not possible for a port and use.
Port listings
Lists CBP ports with FIRMS codes and their facilities.
Test keys
Fixture data that is never counted against quota.

Good for

  • Confirming a FIRMS code is active before filing
  • Finding the code for a terminal or warehouse by name
  • Locating bonded warehouses near an address
  • Checking a code's suitability for a port and entry type
  • Listing every facility at a CBP port

Pricing

Freemium, from $50 a month

Free 20 calls a month; Pro $50 for 200; Enterprise $200 for 2,000; call packs of 100 for $25

Prices change. Check docs.firmsapi.com before you buy.

FIRMSapi FAQ

Does a passing validation mean ACE will accept it?

No. It only means no check against the published CBP list failed; confirm in ACE before filing.

How is it priced?

Each live call counts like the REST call. Plans: Free 20 calls a month, Pro $50 for 200, Enterprise $200 for 2,000.

Can I try it without using quota?

Yes, a fapi_test_ key returns fixture data and is not counted.

Which tools are not available over MCP?

Batch, the changes feed and watchlists; use the REST API.

Is FIRMSapi free?

FIRMSapi has a free plan, with paid plans for more usage or features. Paid plans start at $50 a month.

How do I add FIRMSapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://api.firmsapi.com/mcp

What are the best alternatives to FIRMSapi?

The closest alternatives to FIRMSapi are NY LLC Publication (FileMyPublication), TribuJus, SupplyClub Catalog, SynomosAI Governance MCP and MedXpert 标准检索连接器.

Alternatives to FIRMSapi

  1. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  2. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government
  3. Russian statutes, Supreme Court guidance and court practice for AI assistants

    • 3 tools
    • Remote
    • Free
    • Legal and government
  4. Self-assess AI agent governance: A3 scorecard, ISO 42001 evidence and PII scan

    Runs locally
    • 6 tools
    • Open source
    • Security
  5. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  6. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents