@insightsentry/mcp

MCP server and CLI for the InsightSentry financial data API.

Gives AI assistants direct access to real-time and historical market data for equities, futures, options, crypto, forex, and more — plus comprehensive documentation resources for building applications with the InsightSentry API and WebSocket feeds. Also usable as a standalone CLI for scripting and terminal workflows.

Install

npm install -g @insightsentry/mcp

This gives you two commands:

Get your API key from the InsightSentry Dashboard.

export INSIGHTSENTRY_API_KEY="your-api-key"

MCP Server Setup

No global install needed — use npx in your MCP config.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "insightsentry": {
      "command": "npx",
      "args": ["-y", "@insightsentry/mcp"],
      "env": {
        "INSIGHTSENTRY_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "insightsentry": {
      "command": "npx",
      "args": ["-y", "@insightsentry/mcp"],
      "env": {
        "INSIGHTSENTRY_API_KEY": "your-api-key"
      }
    }
  }
}

Other MCP Clients

Any MCP client that supports stdio transport can use the server:

insight-mcp

CLI Usage

insight --help                    # List all tools
insight <tool> --help             # Tool-specific parameters
insight <tool> [--param value]    # Call a tool

Examples

# Search for a symbol
insight search_symbols --query "tesla"

# Get real-time quotes
insight get_quotes --codes "NASDAQ:AAPL,NASDAQ:MSFT"

# Daily OHLCV with JSONata filter
insight get_symbol_series --symbol "NASDAQ:AAPL" --bar_type day --dp 30 \
  --filter "{ \"last_close\": series[-1].close, \"avg_vol\": \$average(series.volume) }"

# Screen for high-cap stocks
insight screen_stocks --fields "close,volume,market_cap" \
  --exchanges "NYSE,NASDAQ" --sortBy market_cap --sortOrder desc

# Upcoming earnings
insight get_earnings --c US

# Options chain
insight list_options --code "NASDAQ:AAPL" --type call --range 10

All tools support --filter <jsonata> to transform/reduce the JSON response before output. See JSONata docs for expression syntax.

Available Tools (28)

Market Data

Search

Fundamentals

Options

Screeners

Calendar

News & Documents

Documentation Resources

The MCP server also provides documentation resources that AI assistants can read to help you build applications:

Online Documentation

• API Docs: https://insightsentry.com/docs
• WebSocket Live Demo: https://insightsentry.com/test/realtime
• News Feed Demo: https://insightsentry.com/test/newsfeed
• OpenAPI Spec: https://insightsentry.com/openapi.json

Development

npm install
npm run generate  # Generate tool definitions from OpenAPI spec
npm run build     # Generate + compile TypeScript
npm run dev       # Run MCP server with tsx (no build needed)

Testing

npx tsx --test test/cli.test.ts   # CLI unit tests

License

MIT