Loading ToolBench

Reading the current corpus…

zerodha-trade MCP server · F · ToolBench

← Browse

zerodha-trade

github.com/thisizmvk/zerodha-trade

MCP server for placing buy and sell orders on Zerodha trading platform using KiteConnect API

2026-07-28+STDIO2 tools

32/100

Definition Quality25

Protocol Readiness50

SupportabilityNot measured-

Spec posture

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

Static source inference · medium confidence

Current-spec patterns detected

Summary

Both tools have minimal descriptions (under 50 chars) and lack parameter descriptions entirely. Schemas are present but parameters lack type context. Tool names use generic handler suffix rather than verb_noun pattern. No error handling, output schema documentation, or security considerations. Critical gaps across naming, descriptions, and parameter documentation.

Tools (2)

buyStockHandlerwriteauthsource verified25/100

Place a buy order for a stock

sellStockHandlerwriteauthsource verified25/100

Place a sell order for a stock

Issues (5)

HIGHtool-naming ↗

Tool names use generic 'Handler' suffix instead of verb_noun pattern. 'buyStockHandler' should be 'buy_stock' or 'place_buy_order'. LLMs cannot infer intent from 'Handler' suffix.

buyStockHandlersellStockHandler

CRITICALtool-description ↗

Parameter descriptions are completely missing. 'symbol' and 'quantity' have no descriptions explaining format, constraints, or examples. LLMs cannot validate input without this guidance.

buyStockHandlersellStockHandler

HIGHtool-description ↗

Tool descriptions are under 50 characters and lack context. 'Place a buy order for a stock' does not explain when to use this vs alternatives, what it returns, or prerequisites (e.g., authentication, account setup).

buyStockHandlersellStockHandler

HIGHresponse-shaper ↗

No output schema documented. Tools return text responses but LLMs cannot parse structured results or chain to downstream tools. Missing documented return type.

Recommendations

Rename tools to verb_noun pattern: 'buy_stock' and 'sell_stock' instead of 'buyStockHandler' and 'sellStockHandler'.
Add parameter descriptions: 'symbol' should specify format (e.g., 'NSE stock symbol, 1-10 uppercase letters'), 'quantity' should specify range (e.g., 'Number of shares, 1-10000').
Expand tool descriptions to 100-150 chars explaining: what the tool does, when to use it, what it returns, and any prerequisites (e.g., 'Places a market order to buy shares. Returns order ID and confirmation status. Requires active Zerodha session.').
Document output schema explicitly: specify that response contains order_id, status, and timestamp fields. Return structured JSON, not plain text.
Move credentials to environment variables: use process.env.ZERODHA_ACCESS_TOKEN instead of hardcoded 'YOUR_ACCESS_TOKEN'. Never expose secrets in source or as parameters.

Score history

Overall score trend

First recorded score · v2 rubric

32/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	F	32	2026-07-28+	v2