Icici Direct MCP Server

🚀 ICICI Direct MCP Server

A simple MCP server encapsulating HTTP for accessing the ICICI Direct Breeze API.

🚀 Quick Start

🔑 Set API Key

Set your API key in the environment variables:

export ICICI_API_KEY=your_api_key_here

📦 Install Dependencies

Install the required dependencies:

pip install -r requirements.txt

🚀 Run the Server

Start the server:

python server.py

The server will be running at http://localhost:8080.

📚 API Endpoints

• GET /info - Get information about available tools.
• POST /tools/call - Call a tool with parameters.
• POST /tools/{tool_name} - Direct endpoint for each tool.

🐳 Docker Usage

🔨 Build the Docker Image

Build the Docker image for the server:

docker build -t icici-direct-mcp-server .

🚀 Run the Docker Container

Run the Docker container:

docker run -p 8080:8080 -e ICICI_API_KEY=your_api_key_here icici-direct-mcp-server

☁️ Cloud Run Deployment

📤 Submit the Build

Submit the build to Google Container Registry:

gcloud builds submit --tag gcr.io/YOUR-PROJECT/icici-direct-mcp-server

🚀 Deploy to Cloud Run

Deploy the server to Google Cloud Run:

gcloud run deploy icici-direct-mcp-server \
--image gcr.io/YOUR-PROJECT/icici-direct-mcp-server \
--platform managed \
--set-env-vars="ICICI_API_KEY=your_api_key_here"

💻 Usage Examples

🚀 Client Example

This quick setup demonstrates how MCP enables LLMs to use the ICICI Direct Breeze API. Enter your financial data query or type 'Exit' to quit.

💬 Your query: Initialize my ICICI Direct session

🔍 Processing query: Initialize my ICICI Direct session

🤖 Sending query to LLM with MCP tools enabled...

🔧 LLM calls tool: initialize_session
   With parameters: {
     "api_secret": "your_api_secret",
     "session_token": "your_session_token"
   }

📊 Tool result: Session initialized successfully...

🔹 LLM response:
I've initialized your ICICI Direct session. Now you can access financial data.
Do you want to view current market information? We can check current prices, view historical data, or look at your portfolio.

💬 Your query: Connect to WebSocket and display the current price of HDFC Bank