Insight Tool

1. Overview

@insightsentry/mcp connects MCP-compatible AI clients to the InsightSentry API. It lets an assistant search symbols, query market data, screen instruments, inspect options, read documentation resources, render charts, and download history files.

The npm package also includes the insight terminal CLI. Use MCP for AI client workflows and use the CLI when you want direct shell commands or scripts.

2. Setup

Prerequisites

Install Node.js 18 or newer and get your API key from the Dashboard.

Claude Code

Claude Code can add the npm package directly from the terminal:

claude mcp add insightsentry \
  --env INSIGHTSENTRY_API_KEY=your-api-key \
  -- npx -y @insightsentry/mcp

This writes the same stdio server configuration for you.

Codex CLI

Codex can add the npm package as a local stdio MCP server:

codex mcp add insightsentry \
  --env INSIGHTSENTRY_API_KEY=your-api-key \
  -- npx -y @insightsentry/mcp

Run codex mcp list to verify the server was saved.

opencode

Use the opencode MCP wizard and choose a local server:

opencode mcp add

# Use these values when prompted:
# Name: insightsentry
# Type: local
# Command: npx -y @insightsentry/mcp
# Environment: INSIGHTSENTRY_API_KEY=your-api-key

Run opencode mcp list to confirm the server is configured.

OpenClaw

Use OpenClaw's MCP config command to save the npm stdio server:

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

Run openclaw mcp list to confirm the saved entry.

Other MCP Clients

Any MCP-compatible client can also start the npm package through stdio. Configure the client to run:

INSIGHTSENTRY_API_KEY=your-api-key npx -y @insightsentry/mcp

3. Verify

After the client restarts, ask it to use the InsightSentry server for a small request:

If the assistant does not know the exact InsightSentry symbol code, ask it to call search_symbols first. InsightSentry uses codes such as NASDAQ:AAPL, which can differ from ticker formats on other platforms.

4. Optional CLI

Install globally if you want the insight, insight-mcp, and mcp commands available in your shell.

npm install -g @insightsentry/mcp

Authentication

The CLI can use INSIGHTSENTRY_API_KEY or a saved key from insight login. Environment variables take priority.

# Save a key for CLI use
insight login

# Or use a key only for the current shell
export INSIGHTSENTRY_API_KEY="your-api-key"

# Remove the saved key
insight logout

Common Commands

# See available commands
insight --help

# Get help for a specific tool
insight <tool> --help

# Query quotes
insight get_quotes --codes "NASDAQ:AAPL,NASDAQ:MSFT"

# Download historical bars
insight download_history --symbol "NASDAQ:AAPL" --bar_type day \
  --from 2024-01-01 --to 2024-06-30 --output_dir ./history

Most API tools also support --filter <jsonata> to transform JSON output before printing it.

5. Tool Coverage

The MCP server exposes the same core market-data workflows as the CLI. Use insight --helpor your MCP client's tool list for exact argument schemas.

6. Docs Resources

The server includes documentation resources that MCP clients can read while helping you build against the REST API and WebSocket feeds.

7. Examples

Useful prompts are specific about the symbol, data type, and output.