About Finvasia MCP Server
Finvasia MCP Server is a Node.js bridge between Finvasia Shoonya and trading applications. It lets MCP clients retrieve account and market data and manage several types of orders through a standardized interface.
Key features
- 01Retrieve profile and account balance
- 02View prices, positions, and holdings
- 03Place buy, sell, and options orders
- 04Cancel and modify orders
- 05Inspect order, trade, and margin data
- 06Place take-profit and stop-loss orders
Use cases
- 01Check a Finvasia account balance and holdings
- 02Review current stock prices and positions
- 03Manage orders from an MCP-compatible application
MCP support
Exposes Finvasia account, market-data, and order-management operations to MCP clients over stdio or SSE.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEFinvasia MCP Server
A Node.js-based server that connects to Finvasia's Market Connect Protocol (MCP) to enable seamless interaction with the Finvasia trading platform. This server acts as a bridge between Finvasia’s API and your trading application or frontend dashboard.

📌 Current Features
- 👤 Fetch User Profile Data
- 💰 Fetch Account Balance
- 🟢 Buy Orders
- 🔴 Sell Orders
- ❌ Cancel Orders
- ✏️ Modify Orders
- 📈 Current Stock Prices
- 📊 Positions
- 💼 Holdings
- 💸 Order Margin
- 📚 Order Book
- 📒 Trade Book
- 🎯 Take Profit Orders
- 🛑 Stop Loss Orders
- 🧠 Options Buy & Sell
More features and modules will be added progressively.
🛠️ Tech Stack
- Backend: Node.js
- Broker API: Finvasia Shoonya (MCP)
Finvasia MCP Integration
This repository provides a basic integration setup for Finvasia API with the Model Context Protocol (MCP) server. It enables you to connect and access your Finvasia account through a standardized stdio interface, allowing seamless compatibility with MCP-based applications.
🚀 Getting Started
1. Clone the Repository
git clone https://github.com/HexaMCP/Finvasia.git
cd Finvasia
2. Install Dependencies
npm install
🔐 3. Environment Setup
Create a .env file in the root directory with the following keys from Finvasia:
ID="Your Finvasia ID"
PASSWORD="Your Password"
VENDOR_KEY="Your Vendor Key"
IMEI="Your IMEI"
API_KEY="Your API Key"
TOTP="Your TOTP Code"
4. Build the Project
npm run build
5. Start the Project
npm start
Start the MCP server in your respective port (ex: http://localhost:3000)
⚙️ MCP Configuration for SSE
In your mcp config json, add the following configuration block:
{
"Your MCP project name": {
"type": "sse",
"url": "http://localhost:3000",
}
}
🗂️ Where to add this configuration:
For VS Code users, this config should be placed inside your settings.json.
📞 Support
For any issues or assistance with the integration, please contact blaze.ws for support.
You can reach out to us for troubleshooting, feature requests, or any general inquiries related to this MCP integration.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.