Trade It MCP

Trade It MCP Skill

Trade It connects MCP clients directly to the user's brokerage accounts. Use the tools below to search assets, review account balances, and place real trades through natural language.

Available Tools

Safety Model — Read This First

Trade It uses a draft-first execution model. Every trade starts as a draft and is never placed with the broker until the user explicitly confirms.

Required flow:

1. Call create_trade or create_options_trade → returns a draft order with a trade_id
2. Display the order details and inform the user they can execute it
3. Call execute_trade only when the user explicitly says to execute/confirm/place the trade
4. Never call execute_trade automatically or immediately after creating a draft

After creating a draft, always tell the user:

"When you are ready, you can place the order by pressing the Execute button."

Execution Flow

User requests trade
       ↓
[Optional] search_assets — confirm ticker, get current price
       ↓
[Optional] get_accounts — identify correct account_id
       ↓
create_trade / create_options_trade → returns draft with trade_id and status: "draft"
       ↓
Display draft details to user, prompt to confirm
       ↓
User confirms → execute_trade(trade_id)
       ↓
Returns updated trade with status: "placed" or "failed"

Tool Reference

search_assets

Look up a stock or crypto by ticker symbol or company/coin name.

Parameters:

• query (string) — ticker symbol or name (e.g., "TSLA", "Tesla", "bitcoin")

Returns: Asset info including current price, ticker, exchange, and asset type.

Example:

{ "query": "TSLA" }

get_accounts

List all linked brokerage accounts. Also used when the user wants to connect a new brokerage.

Parameters: (none)

Returns: Array of accounts, each with id, name, brokerage, balance, and available_cash.

Use account.id as the account_id in trade calls when the user specifies a particular account.

create_trade

Create a draft equity or crypto order.

Parameters:

Order Types:

Examples:

Buy $500 of Apple at market:

{ "symbol": "AAPL", "amount": 500, "unit": "dollars", "buy_or_sell": "buy" }

Buy 10 shares of NVDA only if it drops to $800 or below:

{ "symbol": "NVDA", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "limit", "limit_price": 800 }

Sell 5 shares of Meta if the price falls to $450 (stop loss):

{ "symbol": "META", "amount": 5, "unit": "shares", "buy_or_sell": "sell", "order_type": "stop", "stop_price": 450 }

Buy 10 shares of AAPL if it breaks above $200, but pay no more than $202:

{ "symbol": "AAPL", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "stop_limit", "stop_price": 200, "limit_price": 202 }

Buy $1,000 of Bitcoin:

{ "symbol": "BTC", "amount": 1000, "unit": "dollars", "buy_or_sell": "buy" }

Sell all (100 shares) of Tesla, good till canceled:

{ "symbol": "TSLA", "amount": 100, "unit": "shares", "buy_or_sell": "sell", "time_in_force": "gtc" }

create_options_trade

Create a draft single-leg or multi-leg options order (spreads, straddles, etc.).

Parameters:

Leg Fields:

OCC Format

Options are identified using the OCC (Options Clearing Corporation) standard format:

YYMMDD[C|P]STRIKE

OCC Examples:

Strike price formula: Multiply dollar strike by 1000, then zero-pad to 8 digits.

• $250 → 250 × 1000 = 250000 → 00250000
• $1,500 → 1500 × 1000 = 1500000 → 01500000
• $50.50 → 50.5 × 1000 = 50500 → 00050500

Options Examples

Single call option — Buy 1 SPY call at $520 strike, expiring Jun 20, 2025:

{
  "symbol": "SPY",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00520000", "quantity": 1 }
  ]
}

Bull call spread (debit) — Buy TSLA $250 call, sell TSLA $260 call, both expiring Jun 20, 2025:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

Max loss = net debit paid. Max gain = $10 spread width minus net debit.

Bear put spread (debit) — Buy SPY $520 put, sell SPY $510 put, expiring Jun 20, 2025:

{
  "symbol": "SPY",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00520000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 }
  ]
}

Bull put spread (credit) — Sell SPY $510 put, buy SPY $500 put, expiring Jun 20, 2025:

{
  "symbol": "SPY",
  "direction": "credit",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00500000", "quantity": 1 }
  ]
}

Bull call spread with limit price — Same spread, but only if net debit is $3.50 or less:

{
  "symbol": "TSLA",
  "direction": "debit",
  "order_type": "limit",
  "limit_price": 3.50,
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

Close an existing long call — Sell to close 2 AAPL $200 calls expiring Mar 21, 2025:

{
  "symbol": "AAPL",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "close", "occ": "250321C00200000", "quantity": 2 }
  ]
}

Straddle — Buy 1 TSLA $250 call and 1 TSLA $250 put, both expiring Jun 20, 2025:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00250000", "quantity": 1 }
  ]
}

execute_trade

Execute a draft trade after the user has reviewed and confirmed it.

Parameters:

• trade_id (number) — The id from the draft trade returned by create_trade or create_options_trade

Returns: Updated trade with status "placed" (or "failed" with error details).

Call this only when:

• The user explicitly says "execute", "confirm", "place it", "go ahead", "do it", or similar
• The trade being confirmed is the most recently reviewed draft

Never call this:

• Automatically after creating a draft
• Without the user seeing the order details first
• If the trade status is not "draft"

Trade Status Reference

Supported Brokerages

Clarification Guidelines

Ask for clarification (all at once, not one field at a time) when:

• The order type is ambiguous (e.g., "buy TSLA at $200" — limit or stop?)
• The user requests an options trade but doesn't specify expiry or strike
• Multiple accounts are linked and the user hasn't specified which to use
• The symbol is ambiguous (e.g., ticker collision between stock and crypto)

Do not ask for clarification on fields with clear defaults (amount defaults to the user's default amount, order_type defaults to market, account defaults to the user's primary account).

Disclaimers

• All investing involves risk, including the possible loss of principal
• Trade It is not a financial advisor and does not provide investment advice
• Options trading involves substantial risk and is not appropriate for all investors
• Trade It cannot withdraw funds, transfer assets, or take custody — it can only place trades

Source: trade-it-inc/trade-it-mcp — distributed by TomeVault.