Nuvama-MCP 🛠️
About
Nuvama-MCP 🛠️ integrates Nuvama's trading platform with Claude AI using the Model Context Protocol (MCP) framework. It allows users to interact with the Nuvama trading platform directly through Claude AI to place orders and view holdings.
Explore
- 📈 Place buy and sell orders for stocks.
- 📊 Fetch and display holdings from the API.
- ⚡ FastMCP server integration for easy tool access.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Nuvama-MCP 🛠️Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- 🐍 Python 3.x installed on your system.
- 📦 Required Python packages installed (e.g., FastMCP, APIConnect).
- 🔑 API credentials (API key, secret, and request ID).
- 📄 A CSV file containing stock symbols and exchange details.
1. Clone the repository to your local machine.
2. Install the required Python packages:
pip install -r requirements.txt
3. Update the following placeholders in
index.py:-
api_key: Your API key.-
api_secret: Your API secret.-
request_id: Your request ID.-
settings_file: Path to your settings file.-
csv_file_path: Path to your instruments CSV file.
4. Run the FastMCP server:
uv run trade_mcp_server.py
To enable Claude to recognize the MCP tools, create a configuration file (e.g., claude_config.json) in the appropriate directory and add the following content:
{
"mcpServers": {
"trade": {
"command": "<path_to_uv_executable>",
"args": [
"--directory",
"<path_to_trade_directory>",
"run",
"trade_server.py"
]
}
}
}
Replace <path_to_uv_executable> with the path to your uv.exe file and <path_to_trade_directory> with the path to your project directory. Place this configuration file in the relevant location for Claude to detect it.
This configuration allows Claude to interact with the MCP tools, enabling you to place orders directly from Claude using Natural Language.
Happy Trading! 🚀
The FastMCP server exposes the following tools:
- 🛒 buyorder: Place a buy order.
- 🛍️ sellorder: Place a sell order.
You can call these tools directly from the MCP interface.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"nuvama-mcp \ud83d\udee0\ufe0f": {
"nuvama-mcp": {
"command": "uv",
"args": [
"run",
"trade_mcp_server.py"
]
}
}
}
}McpServers
{
"nuvama-mcp": {
"command": "uv",
"args": [
"run",
"trade_mcp_server.py"
]
}
}This project integrates Nuvama's trading platform with Claude AI using the MCP framework, allows you to interact with nuvama trading platform directly through claude AI.
Features ✨
- 📈 Place buy and sell orders for stocks.
- 📊 Fetch and display holdings from the API.
- ⚡ FastMCP server integration for easy tool access.
Project Structure 📂
- index.py: Contains the core logic for interacting with the trading API.
- trade_mcp_server.py: Implements a FastMCP server to expose trading functionalities as tools.
- .gitignore: Specifies files and directories to be ignored by Git.
Prerequisites ✅
- 🐍 Python 3.x installed on your system.
- 📦 Required Python packages installed (e.g., FastMCP, APIConnect).
- 🔑 API credentials (API key, secret, and request ID).
- 📄 A CSV file containing stock symbols and exchange details.
Setup Instructions 🛠️
1. Clone the repository to your local machine.
2. Install the required Python packages:
pip install -r requirements.txt
3. Update the following placeholders in
index.py:-
api_key: Your API key.-
api_secret: Your API secret.-
request_id: Your request ID.-
settings_file: Path to your settings file.-
csv_file_path: Path to your instruments CSV file.
4. Run the FastMCP server:
uv run trade_mcp_server.py
Using the MCP Tools 🛠️
The FastMCP server exposes the following tools:
- 🛒 buyorder: Place a buy order.
- 🛍️ sellorder: Place a sell order.
You can call these tools directly from the MCP interface.
Configuring Claude for MCP Integration 🤖
To enable Claude to recognize the MCP tools, create a configuration file (e.g., claude_config.json) in the appropriate directory and add the following content:
{
"mcpServers": {
"trade": {
"command": "<path_to_uv_executable>",
"args": [
"--directory",
"<path_to_trade_directory>",
"run",
"trade_server.py"
]
}
}
}
Replace <path_to_uv_executable> with the path to your uv.exe file and <path_to_trade_directory> with the path to your project directory. Place this configuration file in the relevant location for Claude to detect it.
This configuration allows Claude to interact with the MCP tools, enabling you to place orders directly from Claude using Natural Language.
Happy Trading! 🚀
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
