English Français العربية

Secfinapi MCP

Community Other

Standardized SEC EDGAR financial data for US public companies: income statements, balance sheets, cash flow and ratios, normalized from XBRL.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. secfinapi-mcp
  2. Setup
  3. Tools
  4. Environment variables
  5. Run from source
  6. Publishing (maintainer)
  7. License

secfinapi-mcp

MCP server for SECfinAPI — standardized SEC EDGAR financial data (income statements, balance sheets, cash flow, 40+ ratios) as tools for Claude, Cursor, and other AI assistants.

Ask your AI assistant things like "What's Apple's revenue trend?" or "Compare MSFT and GOOGL operating margins" — it fetches the data live through SECfinAPI.

It runs locally on your machine and is a thin wrapper over the SECfinAPI REST API. No server to host, no extra cost.

Setup

  1. Get an API key (free) at https://www.secfinapi.com.
  2. Add the server to your AI assistant's MCP config.
Claude Desktop

Open Settings → Developer → Edit Config and add:

Once published to npm:

{
  "mcpServers": {
    "secfinapi": {
      "command": "npx",
      "args": ["-y", "secfinapi-mcp"],
      "env": { "SECFINAPI_KEY": "your-api-key-here" }
    }
  }
}

Running from source (before publishing):

{
  "mcpServers": {
    "secfinapi": {
      "command": "node",
      "args": ["C:/path/to/sec-financial-mcp/dist/index.js"],
      "env": { "SECFINAPI_KEY": "your-api-key-here" }
    }
  }
}

Restart Claude Desktop. The 6 tools below appear under the tools (🔌) menu.

Cursor / VS Code

Same config shape in the editor's MCP settings — command, args, and the SECFINAPI_KEY env var.

Tools

ToolReturns
get_company_infoCompany metadata + a link to its filings on SEC EDGAR
get_income_statementStandardized income statement (with filing dates)
get_balance_sheetStandardized balance sheet
get_cash_flowStandardized cash flow statement
get_metrics40+ financial ratios (ROE, ROIC, margins, growth…)
list_companiesList / search the available US public companies

Environment variables

VariableRequiredDefault
SECFINAPI_KEYyes—
SECFINAPI_BASE_URLnothe SECfinAPI production API

Run from source

npm install
npm run build
SECFINAPI_KEY=your-key node dist/index.js

Publishing (maintainer)

npm run build
npm publish

License

MIT

Frequently asked questions

What is Secfinapi MCP?

Standardized SEC EDGAR financial data for US public companies: income statements, balance sheets, cash flow and ratios, normalized from XBRL.

How do I install Secfinapi MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Secfinapi MCP open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Secfinapi MCP?

It is published by michalperni11-gif. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.