Skip to main content

GetMcpCapabilities

Returns the live capability map for the connected add-on. This should be the very first tool an agent calls in any session.

PropertyValue
Required scopemcp:read
RiskNone. Read-only.
Side effectsNone.

When an agent should use it​

  • At the start of every session before any other tool.
  • After reconnect or after a long idle window.
  • Before any code path that depends on RunStrategyBacktest or WriteNinjaScriptFile.

When an agent should not use it​

  • It is cheap to call. There is no real "should not" except spamming it in a tight loop.

Parameters​

None.

Response shape​

{
  "addon_version": "1.13.0",
  "nt8_version": "8.1.6.3",
  "features": ["compile", "strategy_state", "alert_relay", "backtest", "webhook_signals", "journal"],
  "backtest_engine": {
    "available": true,
    "engine": "nt8_strategy_analyzer",
    "nt8_version": "8.1.6.3"
  }
}

Fields may evolve; check features for the live list. Older add-ons return a smaller payload.

Example user prompt​

Call GetMcpCapabilities. Report add-on version, NT8 version, backtest engine
availability, and the features list. Stop after this single call.

Example tool call​

{
  "name": "GetMcpCapabilities",
  "arguments": {}
}

Example response​

{
  "addon_version": "1.13.0",
  "nt8_version": "8.1.6.3",
  "features": ["compile", "strategy_state", "alert_relay", "backtest", "webhook_signals", "journal", "drawings"],
  "backtest_engine": {
    "available": true,
    "engine": "nt8_strategy_analyzer",
    "nt8_version": "8.1.6.3"
  }
}

Common errors​

SymptomLikely causeFix
addon_disconnectedNT8 is closed or the add-on is not connected.Open NT8 and verify the add-on panel.
features missing backtestAdd-on is below v1.13.0.Update the add-on.
Tool not listedToken failed OAuth or scope was rejected.Reauthorize.

Safe workflow placement​

GetMcpCapabilities  → McpSelfTest  → ListAccounts  → GetConnections  → ...

If backtest_engine.available is false, the agent should not attempt RunStrategyBacktest and should explain why.