For developers
| Endpoint | https://mcp.definedgesecurities.com/mcp |
| Transport | Streamable HTTP |
| Sign-in | Through the GetLogin tool: the user signs in on signin.definedgesecurities.com and the tools take the returned session_id. Connector-level OAuth is optional; clients can connect with no authentication |
| Session | Most tools take a session_id. If it is missing or expired, the tool says so; call GetLogin, which returns a sign-in URL and a new session_id. SearchInstrument, DownloadMaster, getScannerMatches, getTopMfBuyingByMCap and getTopMfSellingByMCap work without one |
| Capabilities | 61 tools; no prompts or resources |
Orders
Seven tools change the account: placeOrder, modifyOrder, cancelOrder, placeGttOrder, modifyGttOrder,
cancelGttOrder, placeSliceOrder. Values are sent as strings.
| Exchanges | NSE, BSE, NFO, BFO, CDS, MCX |
| Price types | LIMIT and SL-LIMIT only (SL-LIMIT needs trigger_price). No market orders |
| Products | CNC, INTRADAY, NORMAL |
| Validity | DAY, EOS, IOC; amo = "Yes" for after-market orders |
| GTT | condition = LTP_ABOVE or LTP_BELOW; alert_price is the trigger, price the order price |
| Slices | quantity is per slice; total = quantity × slices. The response has one order ID per slice |
| Tagging | Remarks are stored as MCP (<your remarks>) |
Confirmation protocol. The first call to an order tool, without confirmation_token, places nothing. It
returns status: CONFIRMATION_REQUIRED, an order_summary and a confirmation_token. The client shows the
summary to the user and, after the user confirms, repeats the call with the same arguments plus the token. Tokens
are single-use and expire after 120 seconds. A wrong or expired token returns CONFIRMATION_REJECTED; call again
without a token to get a new one.
When to use the Integrate API instead
Programs that trade on their own, streaming data and high request rates belong on the Integrate API. Definedge MCP is for conversations: a person asks and confirms.
Machine-readable docs
llms.txt: an index of these docs for AI assistants.llms-full.txt: the whole guide as one plain-text file.