freshfilings-mcp 0.1.0

MCP server for FreshFilings — search business entity filings from NY, FL, and CO

freshfilings-mcp

MCP server for FreshFilings — search business entity filings from New York, Florida, and Colorado directly from your AI assistant.

Get an API key

Sign up and subscribe at freshfilings.dev.

Claude Desktop setup

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "freshfilings": {
      "command": "uvx",
      "args": ["freshfilings-mcp"],
      "env": {
        "FRESHFILINGS_API_KEY": "ff_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. No separate install step needed — uvx handles it.

Cursor / Windsurf setup

Add to .cursor/mcp.json (Cursor) or .windsurf/mcp.json (Windsurf):

{
  "mcpServers": {
    "freshfilings": {
      "command": "uvx",
      "args": ["freshfilings-mcp"],
      "env": {
        "FRESHFILINGS_API_KEY": "ff_your_key_here"
      }
    }
  }
}

Available tools

Tool	Description
search_businesses	Search by name across NY, FL, CO. Optional state filter.
get_business_detail	Full record — officers, addresses, registered agent.
get_new_formations	Businesses formed since a given date (YYYY-MM-DD).
check_usage	API key tier, monthly limit, and calls remaining.

Example prompts

• "Search for LLCs named Acme in New York"
• "Show me all new businesses formed in Florida since January 1, 2026"
• "Look up the full record for Colorado entity 12345678"
• "How many API calls do I have left this month?"