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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.