StockLens

AI Integrations

Access StockLens intelligence through the live Model Context Protocol endpoint — usable today in ChatGPT, Claude, and any MCP-compatible client.

Three surfaces

Where investors already work with AI

StockLens speaks the same protocol as ChatGPT, Claude, and any MCP-compatible client -- so the intelligence moves to where the question is asked.

ChatGPT App
ChatGPT App

Query StockLens analysis inside the ChatGPT Apps runtime.

Claude
Claude

Use StockLens tools in Claude Code or claude.ai.

Model Context Protocol
Model Context Protocol

Point any MCP-compatible client at the StockLens server.

Capability mirror

The tools your agent actually calls

Every capability surfaced through ChatGPT, Claude, or a direct MCP client maps to one of these four tools.

get_market_summary
Auth: OAuth

Retrieve the latest nightly composite analysis summary for any ticker -- score, grade, domain breakdown, strengths, and challenges.

Inputs
tickerstring (e.g. AAPL, MSFT, TSLA)
exchange?string (e.g. NASDAQ, TSX, LSE). See full list below. Auto-resolved via autocomplete if omitted.
Outputcomposite_score, composite_grade, domain_scores[], key_strengths[], key_challenges[]
initiate_analysis
Auth: OAuth

Kick off a full StockLens AI analysis for a ticker. Consumes one standard or plus credit.

Inputs
tickerstring (e.g. AAPL)
exchange?string (e.g. NASDAQ, TSX, LSE). See full list below. Auto-resolved via autocomplete if omitted.
time_range?short_2_wk | medium_1_mo | medium_2_mo | long_1_yr | long_2_yr (default medium_1_mo)
risk_tolerance?low | medium | high (default medium)
depth?standard | plus (default standard) (FREE tier cannot use depth="plus")
Outputanalysis_id, status, estimated_seconds, depth, credits_consumed
CreditsLENS_AILENS_AI_PLUS
fetch_analysis_result
Auth: OAuth

Poll progress or retrieve a completed analysis by id. Returns status plus full scored result on completion.

Inputs
analysis_idstring (id returned by initiate_analysis)
Outputstatus, progress_pct, retry_after_seconds -- or result object with ticker, scores, domains, strengths, challenges
get_portfolio_insights
Auth: OAuth

Retrieve composite scores for every stock in the authenticated user's watchlist. FREE tier capped at 3 holdings.

Outputwatchlist[], total_holdings, tier_limited, aggregate_signal
Protocol transparency

What MCP standardizes -- and what StockLens commits to

The Model Context Protocol is an open contract between an AI client and a tool server. StockLens implements it so any MCP-aware assistant -- ChatGPT, Claude, or a custom client -- can discover, call, and verify our analysis tools without bespoke glue code.

Together, these commitments define what each tool exposes, how calls are authorized, and which actions can change account state.

Typed tool registration

Tools declare their schema

Each StockLens tool publishes its name, input parameters, and output shape through MCP discovery. Clients see structured capabilities, not free-form prompts.

User-scoped auth

Industry-standard OAuth across every surface

ChatGPT, Claude, and direct MCP clients all negotiate OAuth 2.0 Authorization Code with PKCE. Every call runs as the end user after StockLens resolves their account and tier.

Capability surface

Read-only, except for analysis initiation

Agents read pre-computed nightly scores, initiate credit-gated analyses, poll progress, and retrieve the authenticated user’s watchlist summaries. The only write path is the daily credit counter -- no portfolio mutation, no trade execution.

Safety boundaries

No PII, no cross-user access

Tool calls never carry personal identity -- handlers operate on your account and subscription tier alone, never your email or profile. Requests for analyses you cannot access return a generic not-found response, so the system never reveals another user’s activity.

Fair use

Per-tier daily quotas

MCP tool-call quotas are separate from your combined analysis credits and reset daily at 00:00 UTC.

Free

10 standard tool calls/day · No plus-depth

Pro

50 standard + 25 plus-depth tool calls/day

Max

Unlimited tool calls (subject to fair use)

Sample dialogue

An illustrative StockLens tool flow

A scripted AAPL transcript showing how an agent requests the latest nightly summary, then starts a separate full analysis.

Sample transcript · illustrative
You

What does the latest nightly AAPL summary show? Give me the composite and the domain breakdown.

StockLens
get_market_summary({ ticker: "AAPL" }) -> composite_score: 78, composite_grade: "B+", domain_scores: { fundamental: 82, technical: 74, risk: 71, sentiment: 80, macro: 69 }
StockLens

In this illustrative transcript, the latest nightly AAPL summary is 78 (B+). Fundamental and sentiment lead; risk and macro are the soft spots. Want me to start a separate full analysis with a long horizon?

You

Yes -- long horizon, medium risk, standard depth.

StockLens
initiate_analysis({ ticker: "AAPL", time_range: "long_1_yr", risk_tolerance: "medium", depth: "standard" }) -> analysis_id: "a_01HXYZ", status: "pending", estimated_seconds: 30, credits_consumed: "LENS_AI"
StockLens

Running. One analysis credit consumed. I will poll fetch_analysis_result and share the synthesis report when it completes.

Access pathways

How to point your AI at StockLens

Connect from claude.ai, the ChatGPT app, or any MCP client -- one auth story, industry-standard OAuth 2.0 Authorization Code with PKCE on every path.

claude.ai

  1. Open Settings → Connectors → Add custom connector in claude.ai

  2. Point it at https://mcp.stocklens.com/mcp and sign in with OAuth (Pro, Max, Team, or Enterprise)

  3. Enable StockLens from the + menu in any chat

Any MCP client

  1. Point your MCP-compatible client at https://mcp.stocklens.com/mcp

  2. Complete the secure OAuth sign-in when prompted

  3. StockLens tools appear in your client

ChatGPT App

  1. Install the StockLens app from the ChatGPT app directory

  2. Sign in with secure OAuth on first use

  3. Call StockLens tools from any ChatGPT conversation

After you sign in, Settings → AI Integrations has your endpoint and the exact setup steps for each client.

Explore More

Capabilities that work together