ICICI Direct MCP Server

The ICICI Direct MCP Server is an HTTP‑wrapped Model Context Protocol (MCP) endpoint that exposes the ICICI Direct Breeze API to AI assistants. By translating standard MCP calls into REST requests against the bank’s trading platform, it gives Claude and other AI agents instant access to real‑time market data, portfolio information, and trade execution capabilities without the need for custom integration code. This eliminates a major friction point for developers building finance‑focused conversational agents: they no longer have to handle OAuth flows, API key management, or request signing manually.

At its core, the server implements three MCP‑standard routes: to list available tools, for generic tool invocation, and individual endpoints that map directly to specific Breeze operations (e.g., “place_order”, “get_quote”). The server automatically injects the user’s API key (supplied via ) into each request, ensuring secure and authenticated communication. For developers, this means they can describe a trading action in natural language, have the AI assistant translate it into a tool call, and receive a structured response—all without touching the underlying HTTP details.

Key capabilities include:

• Real‑time market data retrieval – fetch live quotes, historical charts, and market depth with a single tool call.
• Portfolio management – query holdings, account balances, and transaction history effortlessly.
• Trade execution – place market or limit orders, modify or cancel existing trades, and monitor order status.
• Tool discovery – the endpoint lets clients enumerate all supported operations and their required parameters, enabling dynamic UI generation or autocomplete features in conversational interfaces.

Typical use cases span from automated portfolio rebalancing bots to interactive financial advisors that can fetch the latest stock prices on demand. A developer might embed the MCP server in a cloud function and connect it to Claude, allowing users to say “Show me my equity exposure for the next month” and receive a concise summary generated by the AI. Because the server handles authentication and request formatting, developers can focus on higher‑level business logic rather than plumbing.

The MCP server’s design offers several advantages over traditional API wrappers. Its HTTP wrapper makes it language‑agnostic; any client that understands MCP can interact with it, whether it’s a Python script, a Node.js service, or an on‑premises deployment. Docker and Cloud Run support enable rapid scaling, while the simple environment variable configuration keeps secrets out of code. For teams already using MCP for other tools, adding ICICI Direct becomes a matter of deploying one more endpoint and registering its tools—no new SDKs or vendor‑specific libraries required.