filed-mcp-server

An MCP (Model Context Protocol) server that gives AI agents access to US business entity data via the Filed.dev API. Search business registrations across 9 US states, SEC EDGAR filings, federal government contracts, and lobbying disclosures — all from any MCP-compatible client.

Quick Start

1. Get a Filed API key

Sign up at filed.dev — free tier includes 100 lookups/month.

2. Add to your MCP client

Claude Code:

claude mcp add filed -- npx -y filed-mcp-server
# Set your API key as an environment variable
export FILED_API_KEY=fd_live_your_key_here

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "filed": {
      "command": "npx",
      "args": ["-y", "filed-mcp-server"],
      "env": {
        "FILED_API_KEY": "fd_live_your_key_here"
      }
    }
  }
}

Cursor:

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "filed": {
      "command": "npx",
      "args": ["-y", "filed-mcp-server"],
      "env": {
        "FILED_API_KEY": "fd_live_your_key_here"
      }
    }
  }
}

Claude Desktop:

Edit your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "filed": {
      "command": "npx",
      "args": ["-y", "filed-mcp-server"],
      "env": {
        "FILED_API_KEY": "fd_live_your_key_here"
      }
    }
  }
}

3. Use it

Ask your AI: "Search for Lockheed Martin business registrations in Florida" or "Run a full company intelligence report on Palantir Technologies"

Tools

Tool	Description
filed_search_entities	Search business entities by name in any of 9 US states (AK, CO, CT, DC, FL, IA, NY, OR, PA)
filed_get_entity	Get full entity details — officers, registered agent, filing history. Optionally enrich with federal data.
filed_search_sec	Search SEC EDGAR for company filings (10-K, 10-Q, 8-K, S-1, etc.)
filed_search_contracts	Search federal government contracts from USASpending.gov
filed_search_lobbying	Search lobbying disclosures from the Senate LDA database
filed_company_intel	Power tool — searches all 9 states + SEC + contracts + lobbying for a company, returns unified intelligence report with cross-references

Example Prompts

• "Search for Amazon business registrations in New York"
• "Get the full details for entity FL:P06000113830 including federal data"
• "Find SEC 10-K filings for Tesla"
• "What federal contracts has Booz Allen Hamilton received?"
• "Who lobbies for Pfizer and on what issues?"
• "Run a comprehensive intelligence report on Anduril Industries"

Demo: Company Intelligence Reports

Sample outputs from filed_company_intel for three defense companies:

Company	States	Entities	Contracts	Lobbying	Output
Lockheed Martin	8/9	62	$4.96B	$925K	sample-output-lockheed-martin.json
Anduril Industries	6/9	14	$560M	$1.02M	sample-output-anduril.json
Palantir Technologies	3/9	13	$350M	$2.1M	sample-output-palantir.json

See demo/prompts.md for orchestration prompts that pair this server with Notion MCP to build a structured intelligence workspace.

Pairing with Notion MCP

This server works well alongside Notion MCP for building persistent, structured intelligence workspaces. Configure both servers:

{
  "mcpServers": {
    "filed": {
      "command": "npx",
      "args": ["-y", "filed-mcp-server"],
      "env": {
        "FILED_API_KEY": "your_key_here"
      }
    },
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_your_token\", \"Notion-Version\": \"2022-06-28\"}"
      }
    }
  }
}

Then ask: "Research Palantir Technologies using Filed and add the findings to my Notion intelligence hub."

Development

git clone https://github.com/mgrantley/filed-mcp-server.git
cd filed-mcp-server
npm install
npm run build
FILED_API_KEY=your_key node dist/index.js

API Coverage

State registries: AK, CO, CT, DC, FL, IA, NY, OR, PA

Federal sources:

• SEC EDGAR — company filings (10-K, 10-Q, 8-K, S-1, proxy statements, etc.)
• USASpending.gov — federal government contracts and awards
• Senate LDA — lobbying disclosures (clients, registrants, amounts, issue areas)

More states and sources are added regularly. See filed.dev/docs for current coverage.

License

MIT