Indian Stock Market Mcp — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Indian Stock Market Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
MCP server that provides real-time access to Indian stock market data through 15 tools. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client.
Powered by IndianAPI.in.
The server runs via npx - no clone or install needed.
Every MCP client uses the same config structure:
{
"mcpServers": {
"indian-stock-market": {
"command": "npx",
"args": ["-y", "indian-stock-market-mcp"],
"env": {
"INDIAN_STOCK_API_KEY": "your_api_key_here",
"INDIAN_STOCK_API_BASE_URL": "https://your-api-base-url.com"
}
}
}
}Add to your Claude Desktop config file:
| OS | Path |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
Paste the universal config shape above, then restart Claude Desktop.
claude mcp add indian-stock-market \
-e INDIAN_STOCK_API_KEY=your_api_key_here \
-e INDIAN_STOCK_API_BASE_URL=https://your-api-base-url.com \
-- npx -y indian-stock-market-mcpAdd the universal config shape to .cursor/mcp.json in your project root (or global settings).
Add the universal config shape to ~/.codeium/windsurf/mcp_config.json.
Once configured, use natural language in your AI assistant:
Get me the latest details for Tata SteelShow me the 1-year price history for HDFC BankWhat are the trending stocks today?Find all banking stocks and their performanceGet financial statements for Infosys - income statement and balance sheetGive me today's market briefing: NSE most active, price shockers, and commodity prices| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | Stock name (e.g., "Tata Steel", "HDFC Bank") |
Returns: Stock price, market cap, P/E, 52-week high/low, volume, etc.
| Parameter | Type | Required | Description |
|---|---|---|---|
stock_name | string | yes | Stock name |
period | enum | yes | 1m, 6m, 1yr, 3yr, 5yr, 10yr, max |
filter | enum | no | default, price, pe, sm, evebitda, ptb, mcs (default: price) |
| Parameter | Type | Required | Description |
|---|---|---|---|
stock_name | string | yes | Stock name |
stats | string | yes | income, balance, cashflow |
| Parameter | Type | Required | Description |
|---|---|---|---|
stock_name | string | yes | Stock name |
| Parameter | Type | Required | Description |
|---|---|---|---|
stock_name | string | yes | Stock name |
| Parameter | Type | Required | Description |
|---|---|---|---|
stock_id | string | yes | Stock ID or symbol |
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | yes | Industry/sector name (e.g., "Banking", "Pharma", "IT") |
get_trending_stocks, get_market_news, get_nse_most_active, get_bse_most_active, get_price_shockers, get_52_week_high_low, get_ipo_data, get_commodities — no parameters required.
| Variable | Required | Description |
|---|---|---|
INDIAN_STOCK_API_BASE_URL | yes | API base URL from IndianAPI.in |
INDIAN_STOCK_API_KEY | yes | Your API key from IndianAPI.in |
INDIAN_STOCK_API_KEY_ALTERNATE | no | Fallback key for rate-limit rotation |
The server automatically filters and limits API responses to stay within token limits:
For contributors working on the server itself:
git clone https://github.com/aswin-s/indian-stock-market-mcp.git
cd indian-stock-market-mcp
bun install
# Create .env with your API credentials
cp .env.example .env
# Build TypeScript to dist/
bun run build
# Run in development mode (uses tsx, no build step needed)
bun run devserver.registerTool(...) call in src/index.tsfilterResponse() if neededEnsure the environment variables are set in your MCP client config (see Installation above).
If running from source, run bun install (or npm install). If using npx, try npx -y indian-stock-market-mcp to force a fresh install.
Default timeout is 30 seconds. If your API is slower, modify the timeout value in createApiClient in src/index.ts.
| MCP Tool | API Endpoint |
|---|---|
| get_stock_details | /stock |
| get_historical_data | /historical_data |
| get_trending_stocks | /trending |
| get_market_news | /news |
| get_nse_most_active | /NSE_most_active |
| get_bse_most_active | /BSE_most_active |
| get_price_shockers | /price_shockers |
| get_52_week_high_low | /fetch_52_week_high_low_data |
| get_ipo_data | /ipo |
| get_corporate_actions | /corporate_actions |
| get_recent_announcements | /recent_announcements |
| get_financial_statement | /statement |
| get_stock_target_price | /stock_target_price |
| search_industry | /industry_search |
| get_commodities | /commodities |
MIT
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.