@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 email, falling back to uuid.
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 email/uuid 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 | Latest 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 | Current and historical monthly calendars |
get_newsfeed | Financial news |
get_newsfeed_sources | Available news source names |
get_documents, get_document | Filings and transcripts |