Tracking initial public offerings (IPOs) in India moves fast. Grey Market Premiums (GMP) fluctuate by the hour, QIB and NII subscription numbers surge in the final 90 minutes of bidding, and allotment status can drop unexpectedly at midnight. Until recently, if you asked an AI assistant like Claude or ChatGPT about an ongoing IPO, you would get outdated data or an apology about its knowledge cutoff date.

The Model Context Protocol (MCP) changes everything. By connecting the IPO Master MCP Server to your favorite AI platform, you can turn Claude, ChatGPT, or Gemini into an autonomous, real-time Indian stock market analyst.

What is the IPO Master MCP Server?

The IPO Master MCP server is a standardized interface built on Anthropic's Model Context Protocol. It allows AI models to safely invoke real-time read-only tools to retrieve validated Indian IPO market intelligence.

Available Tools at a Glance

• list_open_ipos: Lists all currently active Mainboard and SME IPOs with live GMP, price band, bidding close date, and overall subscription figures.
• list_ipos: Filters IPOs across lifecycle stages (OPEN, UPCOMING, CLOSED, LISTED) with full-text search by name or symbol.
• get_ipo_details: Fetches complete metadata for an IPO, including registrar name, lot size, issue size, face value, price band, and timeline.
• get_ipo_gmp: Returns the latest Grey Market Premium, expected listing price, estimated percentage gain, and historical GMP trend.
• get_ipo_subscription: Returns live category-wise bidding figures across QIB (Qualified Institutional Buyers), NII/HNI, Retail Individual Investors (RII), and Employees.

Quick Start TL;DR: Copy-Paste Configuration

For power users who want the fastest setup, add this remote configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "ipo-master": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://ipomaster.in/api/mcp"]
    }
  }
}

---

Part 1: How to Connect IPO Master MCP to Claude Desktop

Claude Desktop (macOS and Windows) natively supports the Model Context Protocol. Connecting IPO Master takes less than 3 minutes.

Step 1: Locate Your Claude Desktop Configuration File

Open your operating system's file manager or terminal and navigate to the configuration directory:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Step 2: Add the IPO Master Server Entry

Open claude_desktop_config.json in any code or text editor (like VS Code, Notepad, or Cursor) and paste the following snippet:

{
  "mcpServers": {
    "ipo-master": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ipomaster.in/api/mcp"
      ]
    }
  }
}

Note: If you already have other MCP servers configured, simply add the "ipo-master" key inside your existing "mcpServers" object.

Step 3: Restart Claude Desktop and Verify

1. Fully quit Claude Desktop and restart the application.
2. Look at the bottom right corner of the chat input box. You should see a Hammer icon indicating available tools.
3. Click the hammer icon to confirm that list_open_ipos, get_ipo_gmp, and other IPO Master tools are registered.

---

Part 2: How to Connect IPO Master to ChatGPT (Custom GPTs & Actions)

While OpenAI's ChatGPT operates primarily via GPT Actions and web endpoints, you can connect IPO Master's HTTP endpoint directly as a custom tool.

Step 1: Open ChatGPT Custom GPT Builder

1. Log into ChatGPT (Plus, Team, or Enterprise subscription).
2. Click on Explore GPTs in the left sidebar and select + Create.
3. Switch to the Configure tab.
4. Set the Name to "Indian IPO Master AI" and add a short description: "Real-time Indian IPO tracker with live GMP, subscription rates, and allotment analysis."

Step 2: Add Custom Action

Scroll down to the Actions section and click Create new action. Enter the OpenAPI specification URL pointing to the IPO Master API endpoint:

https://ipomaster.in/api/mcp/openapi.json

Step 3: Configure Custom Instructions

In the Instructions box, provide the persona and guidelines for IPO analysis:

You are an expert Indian Stock Market IPO analyst. When the user asks about upcoming or open IPOs:
1. Always call the live IPO Master tools to fetch the latest GMP and subscription figures.
2. Present data in clean markdown tables with issue price, lot size, current GMP (₹ and %), and closing dates.
3. Distinguish clearly between Mainboard IPOs and SME IPOs.
4. Include a standard SEBI educational disclaimer stating that GMP is an unofficial indicator.

---

Part 3: How to Connect to Google Gemini, Cursor, & Windsurf

Modern developer tools and agentic environments like Cursor, Windsurf, and Google Gemini developer SDKs support MCP server integration through project configurations.

Connecting in Cursor or Windsurf

1. Open your IDE Settings and navigate to Features > MCP Servers.
2. Click Add New MCP Server.
3. Select Command type:
   • Name: ipo-master
   • Command: npx -y mcp-remote https://ipomaster.in/api/mcp
4. Save and verify the active green status indicator.

Practical Testing: 3 Live Prompts to Verify Integration

Once your MCP server is connected, test the live connectivity using these sample prompts:

Prompt 1: Fast Market Scan

"List all Indian IPOs currently open for subscription. Include their price band, closing date, and current Grey Market Premium."

Prompt 2: SME High-Gain Screener

"Are there any SME IPOs open right now with an estimated listing gain of over 30%? Show their lot size and total application cost."

Prompt 3: Subscription & Institutional Demand Check

"Check the QIB and NII subscription status for the largest open Mainboard IPO. Is there strong institutional backing on day 2?"

Troubleshooting Common Connection Issues

1. Node / npx Not Found Error

Ensure that Node.js (version 18 or higher) is installed on your computer and available in your system's PATH. You can verify by opening your terminal and running node -v and npx -v.

2. Claude Desktop Tool Not Showing

Verify that your JSON syntax in claude_desktop_config.json is valid. A missing comma or mismatched curly brace will prevent Claude from parsing the configuration.

3. Network Timeouts or Firewalls

If you are behind a corporate proxy or VPN, ensure that outgoing HTTPS requests to https://ipomaster.in are permitted.

Frequently Asked Questions (FAQ)

Is the IPO Master MCP server free to use?

Yes, the public read-only MCP endpoint is free for individual retail investors and AI enthusiasts.

How frequently is the GMP and subscription data updated?

Grey Market Premium (GMP) data is updated continuously throughout the trading day as market rates adjust. Subscription numbers from NSE and BSE are refreshed every 15 to 30 minutes during active market hours.

Can I use this MCP server to automatically submit IPO bids?

No. The IPO Master MCP server is strictly read-only and designed for research, tracking, and analytics. Applications must be placed through your registered stockbroker or ASBA bank account.

Conclusion & Next Steps

Integrating Model Context Protocol with Indian market analytics unlocks unprecedented speed for IPO research. Instead of checking multiple websites for GMP, allotment, and subscription numbers, your AI assistant can synthesize all of it into actionable intelligence in seconds.

Ready to level up your workflow? Check out our deep-dive guide on Turning Claude Desktop into a Real-Time IPO Screener or explore the IPO Master Allotment Checker online.