# Filingrail MCP

> Filingrail MCP is a freemium MCP server for finance and payments. SEC EDGAR financials, insider trades, 8-K events and 13F holdings with source links. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://filingrail.hudsonenterprisesllc.com
- **Repository:** https://github.com/adamhudson777/filingrail-mcp
- **MCP Registry name:** io.github.adamhudson777/filingrail-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/filingrail-mcp
