Skip to content
MCP server

Filingrail MCP

SEC EDGAR financials, insider trades, 8-K events and 13F holdings with source links

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.1.3
Listing updated
1 day ago

About Filingrail MCP

Filingrail MCP is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Filingrail parses raw EDGAR XBRL into consistent JSON, and this package is its MCP front end. It runs as a Python stdio server installed from PyPI, using a RapidAPI key from the user. The free RapidAPI tier allows 50 calls a day with no card.

Responses carry the source filing URL, so numbers can be traced back to the SEC page. Tools resolve a ticker, CIK or name fragment among more than 8,000 issuers, return the latest 10-K and 10-Q line items, historical series up to 20 periods, Form 4 insider trades with transaction codes, 8-K events tagged by item code, and 13F-HR holdings aggregated by CUSIP. A recent-filings feed shows new filings within about five minutes of acceptance.

The README notes that EDGAR data is free, and the value lies in handling the XBRL parsing, tag drift and deduplication for you.

Install

Run in a terminal

claude mcp add filingrail-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' -- uvx filingrail-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "filingrail-mcp": {
      "command": "uvx",
      "args": [
        "filingrail-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "filingrail-mcp": {
      "command": "uvx",
      "args": [
        "filingrail-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "filingrail-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "filingrail-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "filingrail-mcp": {
      "command": "uvx",
      "args": [
        "filingrail-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "filingrail-mcp": {
      "command": "uvx",
      "args": [
        "filingrail-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}

Configuration

  • RAPIDAPI_KEYYour RapidAPI key for the Filingrail API. Get one free (50 calls/day, no card) at https://rapidapi.com/hudson-enterprises-llc-hudson-enterprises-llc-default/api/filingrailRequired

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

search_companies
Resolve a ticker, CIK or name to a company.
get_recent_filings
Recent filings filtered by form or CIK.
get_financials
Latest 10-K and 10-Q normalised line items.
get_financials_history
Historical quarterly or annual series.
get_insider_trades
Form 4 insider transactions.
get_8k_events
8-K events with item codes.
get_13f_holdings
Institutional holdings.
health
API liveness check.

What it does

Normalised financials
Latest and historical statements mapped to standard line items.
Insider trades
Form 4 transactions with reporter relationship and code.
8-K events
Material events tagged with SEC item codes.
13F holdings
Institutional positions aggregated by CUSIP.
Source traceability
Each response links to the originating filing.
Recent filings feed
New filings filterable by form type.

Good for

  • Ask for last quarter's revenue with a filing link
  • Review insider selling at a company
  • Monitor 8-K events for a ticker
  • Look up what a fund holds

Pricing

Freemium

Free tier of 50 calls/day via RapidAPI; paid tiers not stated

Prices change. Check filingrail.hudsonenterprisesllc.com before you buy.

Filingrail MCP FAQ

Do I need an account?

You need a RapidAPI key; the free tier allows 50 calls a day.

How is it installed?

pip install filingrail-mcp, then set RAPIDAPI_KEY in your client config.

Can I trace figures to the SEC?

Yes, responses include the source filing URL.

What licence is the package?

MIT.

Is Filingrail MCP free?

Filingrail MCP has a free plan, with paid plans for more usage or features.

How do I add Filingrail MCP to Claude Code?

Run this command in your terminal: claude mcp add filingrail-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' -- uvx filingrail-mcp

What are the best alternatives to Filingrail MCP?

The closest alternatives to Filingrail MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to Filingrail MCP

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments