Metadata-Version: 2.4
Name: freshfilings-mcp
Version: 0.1.0
Summary: MCP server for FreshFilings — search business entity filings from NY, FL, and CO
License: MIT
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# freshfilings-mcp

MCP server for [FreshFilings](https://freshfilings.dev) — 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](https://freshfilings.dev)**.

## Claude Desktop setup

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

```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):

```json
{
  "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?"*
