Skip to main content

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?"

Metadata

Release files for freshfilings-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for freshfilings-mcp 0.1.0
File Size Uploaded Provenance Actions
freshfilings_mcp-0.1.0.tar.gz 387.1 kB Without provenance Details for freshfilings_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for freshfilings-mcp 0.1.0
File Interpreter ABI Platform Actions
freshfilings_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for freshfilings_mcp-0.1.0-py3-none-any.whl

Total release size: 391.0 kB

Release files / freshfilings_mcp-0.1.0.tar.gz

Download URL freshfilings_mcp-0.1.0.tar.gz
Size 387.1 kB
Tags Source
SHA-256 checksum
How to use checksums
15ddb50fa9ce496765c45696a40a0786b567c8e284c41e72149b2691e6f554e2
BLAKE2b-256 checksum
How to use checksums
fd4f20094e8219e0f6109365d43498ac2337a017da0d7ae9631e4f8d8a256787
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

Release files / freshfilings_mcp-0.1.0-py3-none-any.whl

Download URL freshfilings_mcp-0.1.0-py3-none-any.whl
Size 3.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1f12d09777b0260e9672eeb7b6b67d1e65ded0c9656069b9eaa176dcf28b02b6
BLAKE2b-256 checksum
How to use checksums
9d5e9393fb86fed64bd0750202862054e5064dd75918dc679f1c28451faab24b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

Security for freshfilings-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page