Skip to content
Nyria

Guide / Checked Nov 2026

Can an AI agent read my positions and orders?

Yes. Nyria's MCP server gives Claude, ChatGPT or Cursor seven read-only tools: strategy info, your bots, open positions, recent orders, one order's status, a preview and a plain explanation of any status. The position and order tools answer in text lines with quantity, filled quantity, average price and status. None shows P&L; that lives on the bot page. The same token can also send, so read-only means blocking the send tool in the client. Paper-only bots help only when nobody copies the strategy.

Start free

Official documentation

Read your account from the agent

  1. 1

    Connect the strategy

    Copy the strategy's MCP URL from the Integration tab with Show URL, and add it to Claude, ChatGPT or Cursor. The token at the end is the only credential.

  2. 2

    Make it read-only

    In Claude, set nyria_send_alert to Blocked under Customize, Connectors, Tool permissions. In Claude Code, list only read tools in --allowedTools. Paper-only bots also work if no one copies the strategy.

  3. 3

    Ask for the bots first

    Ask Claude to run nyria_list_bots. You get one line per bot with broker, paper or live, status and position size. That tells you which accounts the other tools cover.

  4. 4

    Read positions and orders

    Ask for open positions, then recent orders. Positions come per broker account with instrument, side, filled quantity and average price. Orders come with action, status, quantity and price.

  5. 5

    Check one order

    Give the agent an order_id from a send or from recent orders and ask for its status. You get each bot's status, filled quantity, fill price, broker and account type.

  6. 6

    Let it explain a status

    Ask what a bot or order status means. nyria_describe_states gives the meaning in plain words, so the agent explains before it guesses.

Messages to copy

A read-only prompt

Run nyria_list_bots, then nyria_positions and nyria_recent_orders. Send nothing.

Works in any MCP client. The send tool stays unused.

The seven read tools

  • nyria_strategy_info: name, status, equity type and active bot count.
  • nyria_list_bots: each bot's broker, paper or live, status and position size.
  • nyria_positions: open positions per broker account, with side, filled quantity and average price. Only positions Nyria opened.
  • nyria_recent_orders: order id, time, instrument, action, status, quantity and price.
  • nyria_order_status: one order across every bot, with filled quantity and fill price.
  • nyria_preview_alert: how Nyria reads an alert. Places nothing.
  • nyria_describe_states: what a bot, strategy, broker, order or plan status means.

What the agent doesn't see

  • No P&L over MCP. Each bot's page shows P&L from closed positions; the strategy page shows Alert P&L, priced when each alert was processed.
  • Accounts that copy the strategy aren't shown. The tools cover your own bots.
  • Results are text lines, not JSON. The agent reads them like a log.
  • Read tools aren't affected by the send limits.
  • One token reads one strategy. Another strategy needs its own URL.

Questions

Is there a read-only token?
No. One strategy has one token, and it can read and send. Block nyria_send_alert in the client, leave it off the allowed list, or, if nobody copies the strategy, put only paper bots on it.
Can the agent see positions I opened by hand?
No. nyria_positions lists only positions Nyria opened. A position another Nyria strategy opened in the same account is marked as another strategy.
Can it cancel an order?
No tool cancels a single order. The only write tool is nyria_send_alert. An exit alert closes, and action FLATTEN cancels the strategy's working orders, then closes what its bots hold.
Does Placed mean filled?
No. Placed means the order went to the broker. Ask nyria_order_status for filled quantity and fill price, or ask nyria_describe_states what the status means.
Does this work in Cursor?
Yes. Cursor takes the same URL in mcp.json with the token in an Authorization header. The read tools give the same text in every client.
All questions

Next

Guides

How do I connect Claude to Nyria through MCP?

A custom connector with your strategy's MCP URL, or one Claude Code command.

Read guide

How do I connect Claude or ChatGPT to my broker?

Claude or ChatGPT sends the alert over MCP, and a Nyria bot places the order at your broker.

Read guide

How do I build an AI trading agent with Claude?

Claude decides, a Nyria bot places. Paper first.

Read guide

Is it safe to let an AI place trades?

It can send a wrong alert. These are the limits around it.

Read guide

Try a paper bot first

No card required. Paper is free. Live trading from $15 a month.

Start free