What is Finvasia

Finvasia is a trading platform that provides access to financial markets through its Market Connect Protocol (MCP). The Finvasia MCP Server is a Node.js-based server that facilitates seamless interaction between the Finvasia trading platform and user applications.

Use cases

Use cases for Finvasia include algorithmic trading applications, personal trading dashboards, automated trading systems, and any application that requires integration with the Finvasia trading platform for executing trades and managing investment portfolios.

How to use

To use Finvasia, clone the repository from GitHub, install the necessary dependencies, set up your environment variables in a .env file, build the project, and start the server. This allows you to connect to your Finvasia account and access various trading functionalities.

Key features

Key features of Finvasia include fetching user profile data, account balance, executing buy and sell orders, modifying and canceling orders, accessing current stock prices, managing positions and holdings, and utilizing order margin, order book, trade book, take profit and stop loss orders, as well as options trading.

Where to use

Finvasia is used in the financial trading sector, particularly for stock trading, options trading, and other investment activities that require real-time data and order management.

Finvasia 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:

🗂️ 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.