# Connect StockLens to an AI assistant

StockLens is a Model Context Protocol server at https://mcp.stocklens.com/mcp (Streamable HTTP).

## What it covers

StockLens scores selected listings nightly across North America, Europe and Asia-Pacific; macro context is drawn from the United States, Canada, the eurozone, the United Kingdom, Switzerland and Japan. It does not score ETFs, funds, indices, options or currencies. Without an account, scores answer for the 600 largest companies by market value; a signed-in account also reaches any company in its own portfolios. Every score carries the date it was computed.

## What needs an account

- `ping` and `get_market_summary` answer with no account.
- `initiate_analysis`, `fetch_analysis_result`, `get_portfolio_insights`, `discover_stocks`, `add_to_watchlist`, `remove_from_watchlist`, `add_to_watchlist_batch` and `inspect_reading` sign in to a StockLens account over OAuth 2.1 with PKCE, as the person's own StockLens user.

## Connect

- **claude.ai**: connect StockLens from [Claude's connector directory](https://claude.ai/directory/connectors/stocklens), or add a custom connector with https://mcp.stocklens.com/mcp. On a Team or Enterprise plan, an owner adds StockLens for the organization first.
- **ChatGPT**: install the StockLens app from the ChatGPT app directory.
- **Any MCP client**: point it at https://mcp.stocklens.com/mcp.

## Reading results

`get_market_summary` results:

- A result with a status other than scored is an answer, not an error; do not retry it unchanged.
- Every result carries freshness; a stale result is StockLens's last computed reading for that listing, not last night's, and should be quoted with its date.

`inspect_reading` uses an exact supplied `reading_ref` and labelled inspection arguments. It reads already-produced evidence without a new analysis or write. Keep dates, material qualifications and evidence roles; assessment-level evidence is not a per-sentence witness. Gated, expired or uncaptured detail stays unavailable, never replaced with today.

## More

- [Tool index](https://mcp.stocklens.com/llms.txt)
- [OAuth protected resource metadata](https://mcp.stocklens.com/.well-known/oauth-protected-resource)
- [Privacy](https://stocklens.com/privacy-policy), [Terms](https://stocklens.com/terms-conditions), [Financial disclaimer](https://mcp.stocklens.com/docs/financial-disclaimer)

Results are informational only and are not investment advice.