Loading ToolBench

Reading the current corpus…

FinMCP MCP server · C · ToolBench

← Browse

FinMCP

github.com/Finance-LLMs/FinMCP

MCP server for real-time Indian stock market data from NSE and BSE exchanges

2026-07-28+STREAMABLE_HTTP11 tools

66/100

Definition Quality72

Protocol Readiness72

Supportability53

Spec posture

Inferred effective spec 2026-07-28+·current baseline 2026-07-28

Static source inference · medium confidence · evidence: Streamable HTTP

Current-spec patterns detected

Summary

IndianMarkets is a financial data tool collection using FastMCP and HTTP transport. All 11 tools are present with descriptions and input schemas visible in the source code. Naming conventions are clear and action-oriented (all use 'get_' prefix). However, several tools lack comprehensive parameter descriptions, output schemas are not formally documented, and error handling is minimal with generic exception messages. The server provides basic financial data retrieval but lacks the polish and robustness expected of production-grade financial tools.

Tools (11)

get_bse_corporate_actionsread onlysource verified70/100

Get corporate actions (dividends, splits) for BSE-listed stocks.

get_bse_quoteread onlysource verified77/100

Get real-time BSE quote with robust error handling.

get_historical_dataread onlysource verified70/100

Get historical data for Indian stocks.

get_index_constituentsread onlysource verified73/100

Fetch component symbols for an NSE index.

get_indian_option_chainread onlysource verified67/100

Get options chain for NSE F&O stocks.

get_indian_stock_inforead onlysource verified75/100

Unified stock info with automatic NSE/BSE detection and fallback.

get_market_moversread onlysource verified70/100

Get buy/sell sentiment for major Indian indices and constituent breadth.

get_market_status

Issues (6)

HIGHresponse-shaper ↗

Output schemas not documented. Tools return dictionaries with undocumented fields, forcing LLMs to infer structure from response content. This violates pattern:tool and pattern:response-shaper, increasing hallucination risk.

get_nse_quoteget_nse_indicesget_nse_market_snapshotget_bse_quoteget_bse_corporate_actionsget_indian_stock_infoget_historical_dataget_indian_option_chainget_market_statusget_market_moversget_index_constituents

HIGHrecovery-guide ↗

Generic error handling with raw exception strings. Error responses like 'NSE quote failed: ...' do not guide LLM recovery. Missing actionable error messages, categorization (retryable vs fatal), or suggestions for next steps per pattern:recovery-guide.

get_nse_quoteget_nse_indicesget_nse_market_snapshotget_bse_quoteget_bse_corporate_actionsget_indian_stock_infoget_historical_dataget_indian_option_chainget_market_status

Recommendations

Document the complete output schema for each tool. For get_nse_quote, explicitly define: {ticker: string, last_price: float, open: float, high: float, low: float, previous_close: float, volume: int, avg_volume: int, 52_week_high: float, 52_week_low: float, timestamp: ISO8601_string, error?: string}. Do this for all 11 tools.
Enhance error responses with actionable guidance. Replace 'NSE quote failed: {str(exc)}' with structured errors: {error: 'NSE quote not found', ticker: 'INVALID', suggestion: 'Verify the ticker symbol is listed on NSE. Call get_nse_indices() to see constituent symbols.', retryable: false}.
Add enum constraints for parameters accepting limited values. For get_nse_indices, document allowed index names: NIFTY 50, NIFTY BANK, NIFTY IT, SENSEX, etc. For get_historical_data, define valid periods: '1d', '5d', '1mo', '3mo', '6mo', '1y', '5y', 'max'.
Implement pagination for result-heavy tools. Add optional limit (1 - 100, default 20) and offset parameters to get_index_constituents. Return {constituents: [...], total_count: int, limit: int, offset: int} to enable chunking.
Clarify dual-mode parameter handling in get_indian_stock_info. Split into explicit parameters: (ticker: string | scrip_code: int) with clear description: 'Provide either ticker (NSE symbol like INFY) or scrip_code (BSE integer like 500209). If both provided, ticker takes precedence.'
Add freshness disclaimers and retry logic. Document in descriptions: 'Returns real-time data from NSE/BSE APIs. If the API is unavailable (e.g., market closed), returns cached data with a note. Retry after 60 seconds during trading hours.'

Score history

Overall score trend

First recorded score · v2 rubric

66/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-21	C	66	2026-07-28+	v2