Skip to main content

EmitMcpAlert

Sends a notification from the agent through the user's configured CrossTrade alert channels. Subtypes can include backtest completion, deployment start, deployment stop, risk threshold crossed, and freeform messages.

PropertyValue
Required scopemcp:trade
RiskLow. Sends a message. Does not affect trading state.
Side effectsA user-visible notification appears.

When an agent should use it

  • After a backtest completes.
  • After a deployment starts or stops.
  • When a kill condition triggers.
  • When the user has asked for a "ping when X happens" prompt.

When an agent should not use it

  • For routine progress updates that would spam the user.

Parameters

{
"subtype": "deployment_started",
"title": "MyEmaCross deployed on Sim101",
"body": "FastPeriod=9 SlowPeriod=21 AtrStop=2.25 quantity=1 MES 06-26",
"channels": ["in_app", "discord"]
}

channels is optional; defaults to the user's preferences.

Response shape

{ "alert_id": "a-12001", "delivered": ["in_app", "discord"] }

Example user prompt

When the backtest finishes, EmitMcpAlert with subtype backtest_completed and a
short summary. Use only in_app and discord. Keep the body under 300 characters.

Common errors

SymptomLikely causeFix
channel_unconfiguredA requested channel is not set up.Configure it in CrossTrade or omit it.