{
  "markdown": "# Angel One MCP Server\n\n[![npm](https://img.shields.io/npm/v/angel-one-mcp)](https://www.npmjs.com/package/angel-one-mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-official-blue)](https://registry.modelcontextprotocol.io/)\n\nTypeScript [Model Context Protocol](https://modelcontextprotocol.io) server for [Angel One SmartAPI](https://smartapi.angelone.in/).\n\nUse it from Claude, Cursor, Copilot, or any MCP client to:\n- place and manage orders\n- read holdings, positions, and funds\n- fetch market data, candles, OI, Greeks, and movers\n- manage GTT rules\n- estimate charges and margin\n\n## Highlights\n\n- Direct `fetch()` integration. No Angel One SDK dependency.\n- Auto TOTP generation from your base32 secret.\n- Lazy login with token refresh in API layer.\n- Safety guard for trading mutations with soft and hard limits.\n- stdio MCP server. Works well with `npx`.\n\n## Discoverability\n\n- npm package: [`angel-one-mcp`](https://www.npmjs.com/package/angel-one-mcp)\n- Official MCP Registry: [`io.github.ameernoufil/angel-one`](https://registry.modelcontextprotocol.io/)\n- GitHub repo: [`ameernoufil/angel-one-mcp`](https://github.com/ameernoufil/angel-one-mcp)\n\nIf your client supports registry-based discovery, search for `io.github.ameernoufil/angel-one`.\nIf your client prefers package installs, use `angel-one-mcp` from npm.\n\n## Quick Start\n\n### Option A: Use with `npx` (recommended)\n\nAdd this to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"angel-one\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"angel-one-mcp\"],\n      \"env\": {\n        \"ANGEL_API_KEY\": \"your_smartapi_key\",\n        \"ANGEL_CLIENT_ID\": \"your_client_id\",\n        \"ANGEL_PASSWORD\": \"your_mpin\",\n        \"ANGEL_TOTP_SECRET\": \"your_base32_totp_secret\"\n      }\n    }\n  }\n}\n```\n\n### Option B: Run from source\n\n```bash\ngit clone https://github.com/ameernoufil/angel-one-mcp.git\ncd angel-one-mcp\nnpm install\ncp .env.example .env\nnpm run build\nnpm start\n```\n\nIf running from source, point your MCP client to `build/index.js`.\n\n## Environment Variables\n\nRequired:\n- `ANGEL_API_KEY`\n- `ANGEL_CLIENT_ID`\n- `ANGEL_PASSWORD`\n- `ANGEL_TOTP_SECRET`\n\nOptional safety limits:\n- `SOFT_MAX_ORDER_QTY` default `25`\n- `HARD_MAX_ORDER_QTY` default `100`\n- `SOFT_MAX_ORDER_VALUE` default `10000`\n- `HARD_MAX_ORDER_VALUE` default `100000`\n\nExample `.env`:\n\n```env\nANGEL_API_KEY=your_smartapi_key\nANGEL_CLIENT_ID=your_client_id\nANGEL_PASSWORD=your_mpin\nANGEL_TOTP_SECRET=your_base32_totp_secret\n```\n\n## Safety Model\n\nTrading mutations are guarded.\n\nSoft limits block by default and can be overridden with `force: true`.\nHard limits cannot be bypassed without changing env vars and restarting the server.\n\nGuarded operations include:\n- `place_order`\n- `modify_order`\n- `create_gtt_rule`\n- `modify_gtt_rule`\n- `convert_position`\n\nFor MARKET orders, the server attempts LTP-based value checks before allowing the request.\n\n## Tool Coverage\n\n- **Auth:** login and logout\n- **Portfolio:** holdings, positions, funds, conversion\n- **Orders:** place, modify, cancel, book lookup, trade lookup\n- **Market:** search, LTP, quotes, candles, OI, Greeks, movers, PCR\n- **GTT:** create, modify, cancel, list, inspect\n- **Calculator:** margin and brokerage estimates\n- **User:** profile\n\nFor an agent-focused onboarding prompt, see [`docs/llm-setup.md`](docs/llm-setup.md).\n\n## Development\n\nRequirements:\n- Node.js 18+\n\nCommands:\n\n```bash\nnpm install\nnpm run build\nnpm run lint\nnpm run lint:fix\nnpm run format\nnpm run dev\nnpm start\n```\n\n## Architecture Notes\n\n- Entry point: `src/index.ts`\n- API client and auth flow: `src/api.ts`\n- Config and safety limits: `src/config.ts`\n- Order guard: `src/guards.ts`\n- Tool registration: `src/tools/index.ts`\n- Tool implementations: `src/tools/*.ts`\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 3801,
  "sha": "b4692cd3a1da8cf6066885971f6ed743f8eb4bf0b9f8ba8e32a8f4a87b7342ed",
  "repo_slug": "ameernoufil/angel-one-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ameernoufil_angel_one_91ea8536/readme"
}