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/mcpAdd to Settings → Connectors → Add custom connector
https://api.firmsapi.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://api.firmsapi.com/mcp"
}
}
}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

NY LLC Publication (FileMyPublication)
MCP serverNew York LLC publication rules, deadline, county prices, clerks and notice text
- 8 tools
- Remote
- Free
- Legal and government
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government

SupplyClub Catalog
MCP serverRussian statutes, Supreme Court guidance and court practice for AI assistants
- 3 tools
- Remote
- Free
- Legal and government
SynomosAI Governance MCP
MCP serverSelf-assess AI agent governance: A3 scorecard, ISO 42001 evidence and PII scan
Runs locally- 6 tools
- Open source
- Security
MedXpert 标准检索连接器
MCP serverRead-only local index of medical-device standards with official links, no standard text
Runs locally- 4 tools
- Free
- Legal and government

SigPen
MCP serverMCP server that drafts e-signature documents while you approve every send
Not checked yet- 13 tools
- Remote
- Freemium
- Files and documents