trade-mcp

An MCP server that lets a language model place real equity orders on a live Groww brokerage account.

MCP (Model Context Protocol) is a standard that lets an AI client discover and call tools on an external server — here, that means letting Claude buy and sell stock.

This spends real money. It ships in DRY RUN mode and stays there until you deliberately turn it off.

Install

bun install
cp .env.example .env      # then fill in your credentials
bun run smoke             # verify the handshake without touching the brokerage

Related MCP server: groww-mcp

Tools

Only symbol and quantity are model-supplied. Exchange, segment, product, validity, and order type are server-side constants — the model cannot switch to intraday leverage, hop exchanges, or change the order type.

Both tools are annotated destructiveHint: true and openWorldHint: true so MCP clients prompt a human before invoking.

Adding a tool means writing one ToolDefinition and appending it to the array in src/tools/index.ts — server.ts iterates the registry and needs no edit. get_holdings, get_quote, and cancel_order are the obvious next ones; they map to groww.holdings.list, groww.liveData.getQuote, and groww.orders.cancel.