TypeScript MCP server for Angel One SmartAPI that lets MCP clients manage trading and portfolio actions, including orders, holdings, positions, funds, market data, GTT rules, and margin/brokerage estimates. It uses direct fetch-based API integration with automatic TOTP login and trading safety limits.
From the registry: Angel One SmartAPI MCP for orders, portfolio, market data, GTT rules, charges, and margin.
Please install the `angel-one` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js 18+** — Node.js version 18 or later is required to run the MCP server via npx.
- **Get Angel One SmartAPI credentials** — Create or obtain your Angel One SmartAPI credentials: API key, client ID, MPIN/password, and base32 TOTP secret. (https://smartapi.angelone.in/)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","angel-one-mcp"]
- required environment variables:
- `ANGEL_API_KEY`: Angel One SmartAPI API key. (example: `<your-smartapi-key>`)
- `ANGEL_CLIENT_ID`: Angel One client ID. (example: `<your-client-id>`)
- `ANGEL_PASSWORD`: Angel One MPIN/password used for authentication. (example: `<your-mpin>`)
- `ANGEL_TOTP_SECRET`: Base32 TOTP secret used to generate login OTPs. (example: `<your-base32-totp-secret>`)
- optional environment variables:
- `SOFT_MAX_ORDER_QTY`: Optional soft limit for maximum order quantity. Defaults to 25; requests over this are blocked unless explicitly forced. (example: `<your-soft-max-order-qty>`)
- `HARD_MAX_ORDER_QTY`: Optional hard limit for maximum order quantity. Defaults to 100; requests over this are always blocked. (example: `<your-hard-max-order-qty>`)
- `SOFT_MAX_ORDER_VALUE`: Optional soft limit for maximum order value. Defaults to 10000; requests over this are blocked unless explicitly forced. (example: `<your-soft-max-order-value>`)
- `HARD_MAX_ORDER_VALUE`: Optional hard limit for maximum order value. Defaults to 100000; requests over this are always blocked. (example: `<your-hard-max-order-value>`)
Note: Preferred install path is the npm package via npx. The README also includes a source-based setup, but npx is the simplest portable option.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.ANGEL_API_KEYrequiredAngel One SmartAPI API keyANGEL_CLIENT_IDrequiredAngel One client IDANGEL_PASSWORDrequiredAngel One MPIN/passwordANGEL_TOTP_SECRETrequiredBase32 TOTP secret used to generate login codesMeta Ads MCP (Facebook + Instagram) - analyze performance, manage budgets, pause campaigns.