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

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:

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