MCP.Market

Angel One MCP server

by ameernoufil·io.github.ameernoufil/angel-one·v1.0.10
No reviews yet

Angel One SmartAPI MCP for orders, portfolio, market data, GTT rules, charges, and margin.

B72/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
New

0 stars63 downloads/wk

Reviews

Write one

Nobody has reviewed Angel One yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Angel One tools (32, 8 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • cancel_gtt_rulewrite action

    Cancel an existing GTT rule by ID.

  • cancel_orderwrite action

    Cancel a pending order by order ID and variety.

  • convert_position

    Convert an existing position from one product type to another (e.g. INTRADAY to DELIVERY).

  • create_gtt_rulewrite action

    Create a GTT (Good Till Triggered) rule. When trigger price is hit, the order is automatically placed.

  • estimate_charges

    Estimate brokerage, STT, transaction charges, GST, SEBI charges, and stamp duty for proposed trades.

  • estimate_margin

    Calculate margin requirements for a batch of potential orders before placing them.

  • get_all_holdings

    Get extended portfolio holdings with total holding value, total investment, total P&L, and P&L percentage.

  • get_bse_intraday

    Get top BSE intraday movers data.

  • get_candle_data

    Get historical OHLCV candle data for a symbol. Intervals: ONE_MINUTE, FIVE_MINUTE, FIFTEEN_MINUTE, THIRTY_MINUTE, ONE_HOUR, ONE_DAY.

  • get_funds

    Get available funds and margins: cash, collateral, utilised margins, net value.

  • get_gainers_losers

    Get top gainers or losers by OI or price change percentage for derivatives.

  • get_gtt_rule_details

    Get details of a specific GTT rule by ID.

  • get_gtt_rule_list

    List GTT rules filtered by status. Returns paginated results.

  • get_holdings

    Get portfolio holdings: stocks owned, quantities, average prices, P&L, LTP.

  • get_ltp

    Get last traded price for a symbol. Also returns open, high, low, close.

  • get_market_quote

    Get market quote data. Modes: FULL (all fields), OHLC, LTP. Pass exchange and token list.

  • get_nse_intraday

    Get top NSE intraday movers data.

  • get_oi_buildup

    Get OI Buildup analysis: Long Buildup, Short Buildup, Short Covering, Long Unwinding.

  • get_oi_data

    Get historical Open Interest data for derivatives. Same intervals as candle data.

  • get_option_greeks

    Get option Greeks (Delta, Gamma, Theta, Vega, IV) for all strikes of a given underlying and expiry.

  • get_order_bookwrite action

    Get all orders for today: pending, executed, rejected. Shows status, prices, quantities.

  • get_order_detailswrite action

    Get detailed information for a specific order by its order ID.

  • get_positions

    Get open positions: intraday/carryforward, buy/sell qty, avg prices, unrealised P&L.

  • get_profile

    Get Angel One user profile: name, email, mobile, exchanges, products, broker info.

  • get_put_call_ratiowrite action

    Get Put-Call Ratio data for the derivatives market.

  • get_trade_book

    Get executed trades for today: fill prices, quantities, timestamps.

  • login

    Authenticate with Angel One SmartAPI. Auto-generates TOTP. Stores session internally.

  • logout

    End Angel One SmartAPI session and invalidate tokens.

  • modify_gtt_rule

    Modify an existing GTT rule. Change price, quantity, or trigger price.

  • modify_orderwrite action

    Modify an existing pending order. Change price, quantity, order type, or trigger price.

  • place_orderwrite action

    Place a buy/sell order on Angel One. Supports NORMAL, STOPLOSS, AMO, ROBO varieties. Returns order ID on success.

  • search_scrip

    Search for trading instruments by name. Returns symbol tokens needed for other tools.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan29 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 128 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Angel One compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
72/100
higher than 45% of 2,174 E-commerce servers
Tools
32
the typical E-commerce server has 6
Tools that change things
25%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
63
more than 57% of 411 E-commerce servers with a package

What its tools let an agent do: 23 read · 1 create · 6 change · 2 delete

Install Angel One in Claude Code, Cursor or VS Code

Runs npx -y angel-one-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add angel-one -- npx -y angel-one-mcp
Add to Cursor

What the publisher says

From the Angel One repository's README, as published. We do not edit it. Read it on GitHub

Angel One MCP Server

TypeScript Model Context Protocol server for Angel One SmartAPI.

Use it from Claude, Cursor, Copilot, or any MCP client to:

  • place and manage orders
  • read holdings, positions, and funds
  • fetch market data, candles, OI, Greeks, and movers
  • manage GTT rules
  • estimate charges and margin

Highlights

  • Direct fetch() integration. No Angel One SDK dependency.
  • Auto TOTP generation from your base32 secret.
  • Lazy login with token refresh in API layer.
  • Safety guard for trading mutations with soft and hard limits.
  • stdio MCP server. Works well with npx.

Discoverability

  • npm package: angel-one-mcp
  • Official MCP Registry: io.github.ameernoufil/angel-one
  • GitHub repo: ameernoufil/angel-one-mcp

If your client supports registry-based discovery, search for io.github.ameernoufil/angel-one. If your client prefers package installs, use angel-one-mcp from npm.

Quick Start

Option A: Use with npx (recommended)

Add this to your MCP client config:

{
  "mcpServers": {
    "angel-one": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "angel-one-mcp"],
      "env": {
        "ANGEL_API_KEY": "your_smartapi_key",
        "ANGEL_CLIENT_ID": "your_client_id",
        "ANGEL_PASSWORD": "your_mpin",
        "ANGEL_TOTP_SECRET": "your_base32_totp_secret"
      }
    }
  }
}

Option B: Run from source

git clone https://github.com/ameernoufil/angel-one-mcp.git
cd angel-one-mcp
npm install
cp .env.example .env
npm run build
npm start

If running from source, point your MCP client to build/index.js.

Environment Variables

Required:

  • ANGELAPIKEY
  • ANGELCLIENTID
  • ANGEL_PASSWORD
  • ANGELTOTPSECRET

Optional safety limits:

  • SOFTMAXORDER_QTY default 25
  • HARDMAXORDER_QTY default 100
  • SOFTMAXORDER_VALUE default 10000
  • HARDMAXORDER_VALUE default 100000

Example .env:

ANGEL_API_KEY=your_smartapi_key
ANGEL_CLIENT_ID=your_client_id
ANGEL_PASSWORD=your_mpin
ANGEL_TOTP_SECRET=your_base32_totp_secret

Safety Model

Trading mutations are guarded.

Soft limits block by default and can be overridden with force: true. Hard limits cannot be bypassed without changing env vars and restarting the server.

Guarded operations include:

  • place_order
  • modify_order
  • creategttrule
  • modifygttrule
  • convert_position

For MARKET orders, the server attempts LTP-based value checks before allowing the request.

Tool Coverage

  • Auth: login and logout
  • Portfolio: holdings, positions, funds, conversion
  • Orders: place, modify, cancel, book lookup, trade lookup
  • Market: search, LTP, quotes, candles, OI, Greeks, movers, PCR
  • GTT: create, modify, cancel, list, inspect
  • Calculator: margin and brokerage estimates
  • User: profile

For an agent-focused onboarding prompt, see docs/llm-setup.md.

Development

Requirements:

  • Node.js 18+

Commands:

npm install
npm run build
npm run lint
npm run lint:fix
npm run format
npm run dev
npm start

Architecture Notes

  • Entry point: src/index.ts
  • API client and auth flow: src/api.ts
  • Config and safety limits: src/config.ts
  • Order guard: src/guards.ts
  • Tool registration: src/tools/index.ts
  • Tool implementations: src/tools/*.ts

License

MIT

Nothing above is checked by us. What we check is on the safety report.

Angel One: common questions

Is Angel One MCP server safe?
Mostly: it is graded B (72/100). Read the Angel One safety report
How do I install Angel One?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Angel One need an API key?
Yes. The registry entry asks for ANGEL_API_KEY, ANGEL_CLIENT_ID, ANGEL_PASSWORD, ANGEL_TOTP_SECRET.
Is Angel One maintained?
The last commit was 166 days ago (2026-05-22). The latest release is v1.0.10.
What can I use instead of Angel One?
Servers from other publishers that do the same job: Polymarket Toolkit MCP server, Pagseguro MCP server and Federal Register MCP server.
How does Angel One compare with other E-commerce MCP servers?
safety score 72/100 (higher than 45% of 2,174 E-commerce servers); tools 32 (the typical E-commerce server has 6); tools that change things 25% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Angel One

Same job from other publishers: the closest match first, then the best rated.

  • Polymarket Toolkit
    Read-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.
    B
  • Pagseguro
    MCP server for PagSeguro/PagBank — orders, Pix, boleto, credit card, charges
    More from codespar →
    B
  • Federal Register
    Federal Register proposed/final rules, notices, executive orders, FAR cases. 8 tools.
    A
  • Federal Register
    Federal Register proposed and final rules, notices, executive orders, and FAR cases. 8 tools.
    A
  • Longbridge
    US/HK markets — 163 tools: quotes, options, orders, fundamentals, screener, IPO, alerts, DCA & grid
    A