---
title: FinImpulse MCP Server
created: 2026-04-21
updated: 2026-04-29
---

# FinImpulse MCP Server

Overview of the FinImpulse MCP Server — how it works, available tools, requirements, and setup references for MCP-compatible AI clients. 

The [FinImpulse](https://finimpulse.com/) MCP Server is an open-source server implementation of the [Model Context Protocol](https://modelcontextprotocol.io/) 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:

- [Claude Desktop](https://developers.finimpulse.com/mcp-clients/#claude-desktop)
- [Claude Code](https://developers.finimpulse.com/mcp-clients/#claude-code)
- [ChatGPT](https://developers.finimpulse.com/mcp-clients/#chatgpt)
- [Cursor](https://developers.finimpulse.com/mcp-clients/#cursor)
- [Windsurf](https://developers.finimpulse.com/mcp-clients/#windsurf)
- [VS Code (Copilot)](https://developers.finimpulse.com/mcp-clients/#vs-code-copilot)
- [Gemini CLI](https://developers.finimpulse.com/mcp-clients/#gemini-cli)
- [Cline](https://developers.finimpulse.com/mcp-clients/#cline)

For per-client setup instructions, refer to the [Supported MCP Clients](https://developers.finimpulse.com/mcp-clients/).

The source code is available on [GitHub](http://github.com/finimpulse/mcp-server-typescript).

## How It Works

The server sits between an AI client and the FinImpulse API:

**AI Client → MCP Server → FinImpulse API → Financial Data**

![Diagram illustrating the FinImpulse MCP flow: an AI tool sends a natural language request to the FinImpulse MCP Server, which maps it to API endpoints and forwards a structured API call to the FinImpulse API. The API returns financial data, which is passed back to the AI tool as a structured response.](https://developers.finimpulse.com/wp-content/uploads/2026/04/mcp-flow-1024x523.webp)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](https://app.finimpulse.com/developer/settings))

## Available Tools

The server exposes 27 tools across 8 functional groups.

**Tool group****Description**Search & DiscoveryAsset search across stocks, ETFs, and mutual fundsMarket DataSnapshot data, historical time series, asset profiles, newsStatistics & PerformanceKey statistics, risk-adjusted metrics, annual returnsFinancial StatementsIncome statement, balance sheet, cash flow, valuation measuresHolders & OwnershipInstitutional holders, insider transactions, mutual fund holdersFund HoldingsPortfolio composition, top holdingsAnalyst Coverage & RatingsAnalyst records, earnings estimates, recommendation breakdowns, upgrades and downgrades OptionsExpiration 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.