English Français العربية

Secfinapi MCP

مجتمعي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

خطوات التثبيت موجودة في التوثيق أدناه. التوثيق

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو Secfinapi MCP؟

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

كيف أثبّت Secfinapi MCP؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل Secfinapi MCP مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Secfinapi MCP؟

ينشره michalperni11-gif. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من القوائم المجتمعية awesome-mcp-servers ومستودع المشروع على GitHub. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.