Secfinapi
About
SEC filings hold every US public company's financials — but they're in XBRL, which is painful to parse. I built **SECfinAPI** to standardize them into clean JSON, and an **MCP server** so AI assistants can use them directly.
Details
- Author
- michalperni11-gif
- GitHub stars
- 1
- Downloads
- 370
- Categories
- Finance, Other, API
Jump to
- Six dedicated MCP tools for financial data retrieval.
- Over 40 financial ratios (ROE, ROIC, margins, growth).
- Standardized income statement, balance sheet, and cash flow.
- Live data fetched on demand from SECfinAPI.
- Runs locally, no server to host or maintain.
- Free API key required; no extra costs.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
SecfinapiCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Obtain a free API key at <https://www.secfinapi.com>.
2. Add the server to your AI assistant’s MCP configuration. For Claude Desktop, open Settings → Developer → Edit Config and insert the appropriate JSON block (either the npm published version or a local build) with the SECFINAPI_KEY environment variable set to your key. For Cursor/VS Code, use the same configuration shape.
3. Restart the assistant. Six tools (e.g., get_income_statement, get_balance_sheet, get_metrics, list_companies) become available under the tools menu.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"secfinapi": {
"secfinapi": {
"command": "npx",
"args": [
"-y",
"secfinapi-mcp"
],
"env": {
"SECFINAPI_KEY": "<YOUR_API_KEY>"
}
}
}
}
}McpServers
{
"secfinapi": {
"command": "npx",
"args": [
"-y",
"secfinapi-mcp"
],
"env": {
"SECFINAPI_KEY": "<YOUR_API_KEY>"
}
}
}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.
- Get an API key (free) athttps://www.secfinapi.com.
- Add the server to your AI assistant's MCP config.
OpenSettings → Developer → Edit Configand add:
{ "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.
Same config shape in the editor's MCP settings —command,args, and theSECFINAPI_KEYenv var.
npm install npm run build SECFINAPI_KEY=your-key node dist/index.js
Brazilian Open Finance MCP — connect 30+ banks (Itaú, Nubank, Bradesco, Santander, Inter, BB, Caixa, C6 and more) to Claude/Cursor. 13 read-only tools.
Live MCP server connecting AI agents to 36+ business data sources. OAuth 2.1 PKCE.
US stock market & financial data — SEC filings full-text search, XBRL fundamentals, 13F institutional holdings, insider & congressional trades, earnings-call transcripts, short interest, and FRED macro; 90+ tools, free tier, self-hostable.
A Model Context Protocol (MCP) server that exposes the FINRA Query API as a set of tools.
Get financial data and details about Romanian companies straight from ONRC and ANAF
Access BIST and global market data directly
Macroeconomic and FX data API + MCP server for 18 currencies with central bank announcements, calendar, COT, commodities, and forex.
MCP (Model Context Protocol) server for Kontomierz.pl — a Polish personal finance platform. Enables AI assistants (Claude Desktop, LibreChat, Cline) to read and manage your bank accounts, transactions, budgets, and scheduled payments — all through a single API. Built in Python, runs locally or in Docker.
Company, KYB, VAT, sanctions, LEI and address data for 15 EU countries (DK, NO, SE, FI, IE, UK, FR, DE, CZ, PL, LV, EE, NL, BE, LU). Free tier 100 lookups/day at addonnordic.com.
Cert-free PSD2 bank data API for AI agents — read EU bank transactions and balances without buying an eIDAS QWAC certificate
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
