ICICI Direct MCP Server

What is ICICI Direct MCP Server?

It is an HTTP-wrapped MCP server that provides access to the ICICI Direct Breeze API. It exposes tools via HTTP endpoints, enabling programmatic interaction with ICICI Direct trading and data services.

How to use ICICI Direct MCP Server?

Set the ICICI_API_KEY environment variable to your API key, install dependencies with pip install -r requirements.txt, then run python server.py. The server listens on http://localhost:8080 and exposes three HTTP endpoints for tool discovery and invocation.

Key features of ICICI Direct MCP Server

• HTTP-wrapped MCP server for ICICI Direct Breeze API
• Simple GET /info endpoint to list available tools
• POST /tools/call and direct per-tool endpoints for invocation
• Docker support for containerized deployment
• Cloud Run deployment configuration provided

Use cases of ICICI Direct MCP Server

• Accessing ICICI Direct trading and portfolio data programmatically
• Integrating ICICI Direct’s Breeze API into MCP‑compatible applications
• Automating trading operations via HTTP-based tool calls
• Running as a containerized service in cloud environments

FAQ from ICICI Direct MCP Server

What API key is required?

The server requires the ICICI_API_KEY environment variable set to your ICICI Direct API key.

How do I run the server?

Install dependencies, set the API key, and run python server.py. The server starts on port 8080.

Can I deploy it using Docker?

Yes. Build and run with docker build and docker run, passing the API key as an environment variable.

Is cloud deployment supported?

Yes. The README includes commands for deploying to Google Cloud Run using gcloud.

What endpoints are available?

GET /info for tool metadata, POST /tools/call for generic tool calls, and POST /tools/{tool_name} for direct invocation of a specific tool.