Lime International

Account Details

## What it does Returns account data: portfolio value, unrealized P/L, positions, cash balances, and margin metrics. In the current runtime, `items[0]` is a JSON-encoded string; decode it before reading its fields. ## When to use - Account balance, positions, and P/L - Full portfolio overview with metrics ## When NOT to use - Just the list of accounts — `get-accounts-list` - Deposits or withdrawals — use the LimeTrader app ## Where to get inputs `account_id` — the `id` field returned by `

My Accounts

## What it does Returns brokerage accounts with their identifier, trade code, and display label. Use a non-empty `id` value as `account_id` for `get-account`. ## When to use - See which accounts the user has - Get an account `id` for subsequent portfolio operations ## When NOT to use - `account_id` is already known — use `get-account` directly - Money operations — use the LimeTrader app ## Where to get inputs No parameters. ## Returns ```json { "items": [ { "id": "A-001", "trade_c

Quotes

## What it does Returns a MarketData quote snapshot: instrument name, price, bid/ask, volume, daily change, and 52-week high/low. Data may be real-time or delayed. ## When to use - Get an instrument's current price - Compare prices of several instruments ## When NOT to use - Instrument reference data — `get-instrument` - Quote and characteristics together — `get-full-quote` ## Where to get inputs `symbols` — known instruments. ## Returns ```json { "items": [ { "symbol": "AAP

Instrument Data

## What it does Returns flat instrument reference data: name, classification, exchange, currency, sector, industry, country, and asset-class-specific parameters. The field set depends on the instrument; absent fields are omitted from JSON. ## When to use - Get an instrument's characteristics and classification - Get its sector, industry, bond, or futures parameters ## When NOT to use - Price only — `get-quote` - Quote and characteristics in one call — `get-full-quote` - Search by name — `se

Full Instrument Data

## What it does Returns the quote and instrument reference data in one call. Each item contains nested `quote` and `instrument` objects. Fields inside both objects depend on the instrument. ## When to use - Get the current quote and instrument characteristics together ## When NOT to use - Price only — `get-quote` - Characteristics only — `get-instrument` ## Where to get inputs `symbols` — known instruments. ## Returns ```json { "items": [ { "symbol": "AAPL@XNGS", "quot

Search Instruments

## What it does Searches for instruments by ticker or name. Results are sorted by relevance, with at most 5 results per page. ## When to use - The user named a company or instrument but did not provide an exact `symbol` - A `symbol` is needed for subsequent calls ## When NOT to use - `symbol` is already known — use `get-quote` or `get-instrument` ## Where to get inputs `query` — from the user. Add filters, page, and page size when needed. ## Returns ```json { "items": [ { "symbol"

My Watchlists

Returns the current user's watchlists and the instruments in each list. This is the key tool for obtaining `watchlist_id`. ## When to use - Show the user's watchlists - Get `watchlist_id` for watchlist operations - Resolve ambiguity when the user provides only a watchlist name ## When NOT to use - Create a watchlist — `create-watchlist` - Add instruments — `add-to-watchlist` ## Parameters No required parameters. ## Returns ```json { "items": [ { "watchlist_id": "wl-abc123",

Create Watchlist

Creates a new empty watchlist. Repeating the call with the same name returns the same watchlist. After creation, populate it via `add-to-watchlist`. ## When to use - The user wants to create a new tracking list ## When NOT to use - View watchlists — `get-watchlists` - Add instruments — `add-to-watchlist` ## Where to get inputs Watchlist name — from the user. ## Returns ```json { "items": [ { "watchlist_id": "wl-new789", "name": "Tech Stocks", "instruments": [] } ], "announcemen

Delete Watchlist

Deletes an entire watchlist. Deleting the same or already absent watchlist again is not an error. ## When to use - The user wants to delete a watchlist ## When NOT to use - View watchlists — `get-watchlists` - Remove individual instruments — `remove-from-watchlist` ## Where to get inputs `watchlist_id` — from `get-watchlists`. Watchlist names are not unique. If the user provides only a name, call `get-watchlists`, show the matching options, and ask them to clarify `watchlist_id`. ## Retur

Rename Watchlist

Renames an existing watchlist and returns its full current state. Repeating the call with the same name does not change the result. ## When to use - The user wants to change a watchlist name ## When NOT to use - View watchlists — `get-watchlists` - Create a watchlist — `create-watchlist` - Add instruments — `add-to-watchlist` ## Where to get inputs `watchlist_id` — from `get-watchlists`; the new name — from the user. Watchlist names are not unique. If the user provides only a name, call `g

Add to Watchlist

Adds one or more instruments and returns the full current watchlist state. Re-adding an instrument does not create duplicates. ## When to use - The user wants to add instruments to a watchlist ## When NOT to use - View watchlists — `get-watchlists` - Remove instruments — `remove-from-watchlist` ## Where to get inputs `watchlist_id` — from `get-watchlists`; `symbols` — from `search-instruments` or directly. Watchlist names are not unique. If the user provides only a name, call `get-watchlis

Remove from Watchlist

Removes one or more instruments and returns the full current watchlist state. Removing an absent instrument again is not an error. ## When to use - The user wants to remove instruments from a watchlist ## When NOT to use - View watchlists — `get-watchlists` - Delete the entire watchlist — `delete-watchlist` ## Where to get inputs `watchlist_id` — from `get-watchlists`; `symbols` — known instruments. Watchlist names are not unique. If the user provides only a name, call `get-watchlists`, sh

Instrument Note

Returns an instrument note. If no note exists, `items` may be empty or the item may omit `text` and `updated_at`; this is not an error. ## When to use - View an instrument note - Check whether a note exists ## When NOT to use - Create or update a note — `update-note` - Delete a note — `delete-note` ## Where to get inputs `symbol` — from `search-instruments` or a known instrument. ## Returns ```json { "items": [ { "symbol": "AAPL@XNGS", "name": "Apple Inc.", "text": "Watch the

Create or Update Note

Creates a note when none exists or completely replaces the existing note for an instrument. An instrument can have only one note. Repeating the call with the same text does not change the result. ## When to use - The user wants to create a note or change existing note text ## When NOT to use - View a note — `get-note` - Delete a note — `delete-note` ## Where to get inputs `symbol` — from `search-instruments` or directly; `text` — from the user. ## Returns ```json { "items": [ {

Delete Note

Deletes an instrument note. Repeated deletion for a valid instrument without a note is not an error. ## When to use - The user wants to delete an instrument note ## When NOT to use - View a note — `get-note` - Create or update a note — `update-note` ## Where to get inputs `symbol` — from `search-instruments` or directly. ## Returns ```json { "items": [ { "symbol": "AAPL@XNGS", "name": "Apple Inc." } ], "announcements": [], "meta": { "as_of": "2026-07-16T10:00:00Z" } } ``` ## Impor

Orders

## What it does Returns the user's trading orders and their statuses: active, partially filled, filled, canceled, rejected, and other states available in the source. MCP receives the data directly from `FGT.GetOrders`. Date filtering and pagination are performed by MCP after it receives and normalizes the order stream from FGT. For LimeTrader, the response includes columns 1-10 of the Orders table: symbol, exchange, type and side, quantity, activation condition, price, time, executed quantity

Operations History

## What it does Returns the account operation history from `BOfficer`, including executed purchases and sales and other available account movements. The number of operations is limited by `limit`. Use the transaction identifier `start_trans_id` to retrieve the next part of the history; the complete operation count and arbitrary page navigation are not calculated. For LimeTrader, each record contains the History table data: operation type, symbol, exchange, quantity, total, price, and time. UI

Show trading chart

## What it does Shows a trading chart widget if the user's client supports MCP-Apps. If such support is not available, brief information about the instrument and candles on the selected timeframe is displayed. ## When to use - Display the trading chart of the selected instrument - Get information about the last candle of the selected instrument ## When NOT to use - Get quotes - Get trades ## Where to get inputs `symbol` — from `search-instruments` or a known instrument. ## Returns ```js