@insightsentry/mcp

MCP server and CLI for the InsightSentry financial data API.

Install

npm install -g @insightsentry/mcp

Commands:

| Command | Purpose | |---------|---------| | insight | CLI for terminal use and scripts | | insight-mcp | MCP server for AI clients | | mcp | Alias for insight-mcp |

Authentication

Set an API key for the current shell:

export INSIGHTSENTRY_API_KEY="your-api-key"

Or save one locally for the CLI:

insight login --key "your-api-key"
insight whoami
insight logout

whoami parses the configured JWT locally and prints uuid, falling back to email then sub.

MCP Setup

Use npx in your MCP config:

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

The MCP server also falls back to the key saved by insight login when INSIGHTSENTRY_API_KEY is not set. Set INSIGHTSENTRY_CONFIG_DIR to force the CLI and MCP server to read the same saved-login directory when they run with different home directories.

CLI Usage

insight --help
insight <tool> --help
insight <tool> [--param value]

Examples:

insight whoami
insight search_symbols --query "tesla"
insight get_quotes --codes "NASDAQ:AAPL,NASDAQ:MSFT"
insight get_symbol_series --symbol "NASDAQ:AAPL" --bar_type day --dp 30
insight screen_stocks --fields "close,volume,market_cap" --exchanges "NYSE,NASDAQ" --sortBy market_cap --sortOrder desc
insight download_history --symbol "NASDAQ:AAPL" --bar_type day --from 2024-01-01 --to 2024-06-30 --output_dir ./history

Symbol codes must use EXCHANGE:SYMBOL format. Use search_symbols before calling symbol tools.

All API tools support:

--filter '<jsonata-expression>'
--store json --output_file ./response.json
--store json --output_dir ./responses

get_symbol_series also supports CSV storage:

insight get_symbol_series --symbol "NASDAQ:AAPL" --bar_type day --store csv --output_file ./aapl.csv

Tools

Auth and files:

| Tool | Purpose | |------|---------| | whoami | Print the configured user's uuid/email from the API key JWT | | download_history | Download date ranges to JSON/CSV files | | get_symbol_history | Same as download_history; downloads history to files | | render_chart | Render Chart.js configs as PNG images |

Market data:

| Tool | Purpose | |------|---------| | search_symbols | Find valid EXCHANGE:SYMBOL codes | | get_quotes | Real-time quotes | | get_symbol_series | Recent OHLCV series | | get_symbol_info | Symbol metadata | | get_symbol_session | Trading hours and session details | | get_symbol_contracts | Futures contract list |

Fundamentals, options, screeners, calendars, documents:

| Tool | Purpose | |------|---------| | get_symbol_fundamentals | Company fundamentals | | get_fundamentals_series | Historical fundamental indicators | | get_fundamentals_meta | Available fundamental/technical IDs | | get_options_contracts | Option contract metadata and codes | | get_options_quotes | Option quote rows with bid/ask and Greeks | | screen_stocks, screen_etfs, screen_bonds, screen_crypto | Screen assets | | get_stock_screener_params, get_etf_screener_params, get_bond_screener_params, get_crypto_screener_params | Screener fields | | get_dividends, get_earnings, get_ipos, get_events | Calendars | | get_newsfeed | Financial news | | get_documents, get_document | Filings and transcripts |