Supported MCP Clients

The Model Context Protocol (MCP) is a standardized interface for communication between AI clients and external data sources. FinImpulse implements this protocol to provide AI clients with access to financial market data.

The FinImpulse MCP Server is compatible with any MCP-supported AI client. Configuration instructions for commonly used MCP clients are provided below, along with a general setup option for any stdio-compatible environment.

Prerequisites

Before proceeding, ensure the following requirements are met:

• Node.js 18 or higher is installed
• A valid FinImpulse API token is available (obtainable in the FinImpulse Dashboard). Keep your API token secure.  

Then follow the configuration instructions for your client in the sections below.

The full source code and additional setup references are available on GitHub.

Claude Desktop

Open Claude Desktop and navigate to Settings → Developer, then select Edit Config to open the configuration file. Alternatively, locate the file manually at the following path, depending on the operating system: 

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Note that MCP support in Claude Desktop requires a paid subscription. 

Add the following server configuration, replacing your-api-token with your FinImpulse API token: 

{
  "mcpServers": {
    "finimpulse": {
      "command": "npx",
      "args": ["-y", "finimpulse-mcp-server"],
      "env": {
        "API_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Code

Claude Code must be installed and configured before proceeding. Refer to the Anthropic documentation for setup instructions.

Run the following command to add the FinImpulse MCP server:

claude mcp add finimpulse -- npx -y finimpulse-mcp-server

Then set the API_TOKEN environment variable:

export API_TOKEN=your-api-token

To verify the connection, run:

claude mcp list

The FinImpulse server should appear in the list of configured MCP servers.

ChatGPT

ChatGPT supports MCP via its desktop application. Open Settings → MCP Servers and add a new server with the following configuration, replacing your-api-token with your FinImpulse API token: 

{
  "mcpServers": {
    "finimpulse": {
      "command": "npx",
      "args": ["-y", "finimpulse-mcp-server"],
      "env": {
        "API_TOKEN": "your-api-token"
      }
    }
  }
}

Cursor

Ensure the latest version of Cursor is installed before proceeding. Then, open the Cursor settings, navigate to Tools & Integrations (or MCP Tools on Windows), and click Add Custom MCP. 

In the configuration file that opens, add the following, replacing your-api-token with your FinImpulse API token: 

{
  "mcpServers": {
    "finimpulse": {
      "command": "npx",
      "args": ["-y", "finimpulse-mcp-server"],
      "env": {
        "API_TOKEN": "your-api-token"
      }
    }
  }
}

Alternatively, open the configuration file directly at ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-level) and add the same configuration. 

Windsurf

Open ~/.codeium/windsurf/mcp_config.json and add the following, replacing your-api-token with your FinImpulse API token: 

{
  "mcpServers": {
    "finimpulse": {
      "command": "npx",
      "args": ["-y", "finimpulse-mcp-server"],
      "env": {
        "API_TOKEN": "your-api-token"
      }
    }
  }
}

VS Code (Copilot)

Open settings.json and add the following, replacing your-api-token with your FinImpulse API token: 

{
  "mcp": {
    "servers": {
      "finimpulse": {
        "command": "npx",
        "args": ["-y", "finimpulse-mcp-server"],
        "env": {
          "API_TOKEN": "your-api-token"
        }
      }
    }
  }
}

Gemini CLI

Gemini CLI must be installed and configured before proceeding. Refer to the Google documentation for setup instructions.

Run the following command to add the FinImpulse MCP server:

gemini mcp add finimpulse -- npx -y finimpulse-mcp-server

Then set the API_TOKEN environment variable, replacing your-api-token with your FinImpulse API token: 

export API_TOKEN=your-api-token

To verify the connection, run:

/mcp list

The FinImpulse server should appear in the list of configured MCP servers.

Cline

Open Cline settings, navigate to MCP Servers, and add a new server with the following configuration, replacing your-api-token with your FinImpulse API token: 

{
  "mcpServers": {
    "finimpulse": {
      "command": "npx",
      "args": ["-y", "finimpulse-mcp-server"],
      "env": {
        "API_TOKEN": "your-api-token"
      }
    }
  }
}

Other MCP-Compatible Clients

Any client that supports the MCP stdio transport can connect to the FinImpulse MCP server. Pass the API token as an environment variable and run: 

API_TOKEN=your-api-token npx finimpulse-mcp-server

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.