The FinImpulse MCP Server is an open-source server implementation of the Model Context Protocol that connects AI clients to the FinImpulse API. It translates MCP tool calls into FinImpulse API requests and returns structured financial data in a format that AI models can interpret directly — without custom client-side integrations.
The MCP server is intended for developers and teams building AI-powered applications that require access to structured financial market data. It is compatible with any MCP-supported AI client, including:
For per-client setup instructions, refer to the Supported MCP Clients.
The source code is available on GitHub.
How It Works
The server sits between an AI client and the FinImpulse API:
AI Client → MCP Server → FinImpulse API → Financial Data
When an AI client issues a tool call, the MCP server processes the request, queries the appropriate FinImpulse API endpoint, and returns a structured response.
This allows AI agents and development environments to retrieve financial data — including quotes, fundamentals, financial statements, ownership data, and fund holdings — through a standardized interface.
Requirements
- Node.js 18 or higher
- A valid FinImpulse API token (available in the FinImpulse Dashboard)
Available Tools
The server exposes 27 tools across 8 functional groups.
| Tool group | Description |
| Search & Discovery | Asset search across stocks, ETFs, and mutual funds |
| Market Data | Snapshot data, historical time series, asset profiles, news |
| Statistics & Performance | Key statistics, risk-adjusted metrics, annual returns |
| Financial Statements | Income statement, balance sheet, cash flow, valuation measures |
| Holders & Ownership | Institutional holders, insider transactions, mutual fund holders |
| Fund Holdings | Portfolio composition, top holdings |
| Analyst Coverage & Ratings | Analyst records, earnings estimates, recommendation breakdowns, upgrades and downgrades |
| Options | Expiration dates, full option chains, single contract snapshots with Greeks |
Disclaimer
FinImpulse MCP Server provides access to financial data and analytics via a standardized interface. It does not generate investment recommendations and does not provide financial, investment, or trading advice.
Any outputs produced by AI systems built on top of this server are for informational and research purposes only. Users are solely responsible for evaluating any information generated by AI agents or applications built on top of FinImpulse MCP. Financial decisions should be based on independent analysis or consultation with a qualified financial professional.