Screener Stock Research — Claude Code MCP server setup
The Screener Stock Research MCP server for Claude Code researches Indian stocks using company financials, market screens and exchange updates. Ask about a ticker, compare companies or filter stocks by criteria.
MIT ★ 28 updated 2026-11-12
claude mcp add --env SCREENER_USERNAME=<SCREENER_USERNAME> --env SCREENER_PASSWORD=<SCREENER_PASSWORD> --transport stdio screener-stock-research -- uvx screener-mcpWhat Screener Stock Research does
The server retrieves Indian company and market information through Screener.in, NSE and MCX. It can compare financial metrics, screen stocks, find analyst targets and news, and retrieve corporate announcements. It also supports questions about annual reports and earnings-call transcripts, plus a local portfolio tracker and research notes.
Fundamental screens require a free Screener.in account; technical-only screens do not. Installation uses uv and uvx. Claude Code receives Screener.in credentials through the SCREENER_USERNAME and SCREENER_PASSWORD environment variables.
What it helps with
- compare financial metrics across Indian companies
- screen stocks by debt and return-on-capital criteria
- find analyst targets, recent news and exchange announcements for a ticker
- pull risks from an annual report or earnings-call transcript
- track profit and loss for a local portfolio
Example prompts for the agent
- Compare ITC and HINDUNILVR across their key financial metrics.
- Find stocks with low debt and high return on capital.
- What risks appear in Reliance's 2024 annual report?
How to install Screener Stock Research
Platform CLI
claude mcp add --env SCREENER_USERNAME=<SCREENER_USERNAME> --env SCREENER_PASSWORD=<SCREENER_PASSWORD> --transport stdio screener-stock-research -- uvx screener-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from screener-mcp <command>
Platform CLI
codex mcp add screener-stock-research --env SCREENER_USERNAME=<SCREENER_USERNAME> --env SCREENER_PASSWORD=<SCREENER_PASSWORD> -- uvx screener-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from screener-mcp <command>
Config file
{
"mcpServers": {
"screener-stock-research": {
"command": "uvx",
"args": [
"screener-mcp"
],
"env": {
"SCREENER_USERNAME": "<SCREENER_USERNAME>",
"SCREENER_PASSWORD": "<SCREENER_PASSWORD>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from screener-mcp <command>
Config file
{
"servers": {
"screener-stock-research": {
"type": "stdio",
"command": "uvx",
"args": [
"screener-mcp"
],
"env": {
"SCREENER_USERNAME": "<SCREENER_USERNAME>",
"SCREENER_PASSWORD": "<SCREENER_PASSWORD>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from screener-mcp <command>
Platform CLI
gemini mcp add -e SCREENER_USERNAME=<SCREENER_USERNAME> -e SCREENER_PASSWORD=<SCREENER_PASSWORD> screener-stock-research uvx screener-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from screener-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Screener Stock Research
How do I install Screener Stock Research in Claude Code?
Add it with claude mcp add screener-mcp -e SCREENER_PASSWORD=<SCREENER_PASSWORD> -- uvx screener-mcp. The command requires uv.
What does Screener Stock Research do?
It researches Indian stocks by comparing company figures, screening shares against criteria, and retrieving reports and exchange announcements.
What does Screener Stock Research need to run?
It uses uv to launch. Fundamental screens require a free Screener.in account, with credentials supplied as SCREENER_USERNAME and SCREENER_PASSWORD.