Skip to main content
Glama

Rafid Intelligence Network

portfolio_exposure_check

Read-onlyIdempotent

Aggregate supplied open and proposed positions into gross, net, directional and concentration exposure with stop-risk and margin indicators. When: Use when an agent needs to assess portfolio concentration or directional exposure before adding or modifying a position. Selection: supporting; prefer for Use when an agent needs to assess portfolio concentration or directional exposure before adding or modifying a position.. Input is a strict JSON object; see the schema. Price: $0.25 USD per call. No free preview is advertised for this capability. Full execution is paid per call via x402; an unpaid MCP call returns payment instructions.

Input Schema

NameRequiredDescriptionDefault
accountNo
positionsYes
correlationsNo
proposedPositionNo

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • removedOutput schema / additionalProperties
      Removed value: -false
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "accountEquity": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "availableFreeMargin": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "concentrationFlags": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "exposurePctOfEquity": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "grossExposure": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "largestConcentrationPct": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "leverage": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "longExposure": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "marginUsage": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "netExposure": {
      +        "type": "number"
      +      },
      +      "openRisk": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "positions": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "concentrationPct": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "direction": {
      +              "enum": [
      +                "long",
      +                "short"
      +              ],
      +              "type": "string"
      +            },
      +            "exposure": {
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "openRisk": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "symbol": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "symbol",
      +            "direction",
      +            "exposure",
      +            "concentrationPct",
      +            "openRisk"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "riskFlags": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "shortExposure": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "sourceTraceability": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "notes": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "portfolioExposure": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          },
      +          "strategyPerformance": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          },
      +          "tradeLog": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          },
      +          "tradeRisk": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "strategyPerformance",
      +          "tradeRisk",
      +          "portfolioExposure",
      +          "tradeLog",
      +          "notes"
      +        ],
      +        "type": "object"
      +      },
      +      "summary": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "grossExposure",
      +      "netExposure",
      +      "longExposure",
      +      "shortExposure",
      +      "exposurePctOfEquity",
      +      "largestConcentrationPct",
      +      "leverage",
      +      "positions",
      +      "concentrationFlags",
      +      "riskFlags",
      +      "summary",
      +      "accountEquity",
      +      "openRisk",
      +      "marginUsage",
      +      "availableFreeMargin"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "nextAction": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "instruction": {
      +            "type": "string"
      +          },
      +          "target": {
      +            "enum": [
      +              "x402_endpoint",
      +              "mcp_credits_endpoint",
      +              "payment_endpoint",
      +              "unavailable"
      +            ],
      +            "type": "string"
      +          },
      +          "type": {
      +            "enum": [
      +              "pay_and_retry",
      +              "authorize_and_use_mcp_credits",
      +              "payment_unavailable"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "target",
      +          "instruction"
      +        ],
      +        "type": "object"
      +      },
      +      "payment": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "endpoint": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "method": {
      +            "const": "POST",
      +            "type": "string"
      +          },
      +          "retrySameBody": {
      +            "const": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "endpoint",
      +          "method",
      +          "retrySameBody"
      +        ],
      +        "type": "object"
      +      },
      +      "paymentGuidance": {},
      +      "preview": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fullResultAvailable": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "inputAccepted": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "summary": {
      +            "type": "string"
      +          },
      +          "useCases": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "inputAccepted",
      +          "fullResultAvailable",
      +          "summary",
      +          "useCases"
      +        ],
      +        "type": "object"
      +      },
      +      "price": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "amount": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "currency": {
      +            "type": "string"
      +          },
      +          "protocol": {
      +            "enum": [
      +              "x402",
      +              "api_credits",
      +              "subscription",
      +              "l402",
      +              "mpp",
      +              "unavailable"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "amount",
      +          "currency",
      +          "protocol"
      +        ],
      +        "type": "object"
      +      },
      +      "requestId": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "payment_required",
      +        "type": "string"
      +      },
      +      "tool": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "tool",
      +      "requestId",
      +      "price",
      +      "preview",
      +      "payment",
      +      "nextAction"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / properties
      Removed value: -{
      -  "accountEquity": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "availableFreeMargin": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "concentrationFlags": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "exposurePctOfEquity": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "grossExposure": {
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  "largestConcentrationPct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "leverage": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "longExposure": {
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  "marginUsage": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "netExposure": {
      -    "type": "number"
      -  },
      -  "openRisk": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "positions": {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "concentrationPct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "direction": {
      -          "enum": [
      -            "long",
      -            "short"
      -          ],
      -          "type": "string"
      -        },
      -        "exposure": {
      -          "minimum": 0,
      -          "type": "number"
      -        },
      -        "openRisk": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "symbol": {
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "symbol",
      -        "direction",
      -        "exposure",
      -        "concentrationPct",
      -        "openRisk"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "riskFlags": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "shortExposure": {
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  "sourceTraceability": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "notes": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "portfolioExposure": {
      -        "enum": [
      -          "GROK",
      -          "SIGNALFLOW",
      -          "MERGED",
      -          "NEW"
      -        ],
      -        "type": "string"
      -      },
      -      "strategyPerformance": {
      -        "enum": [
      -          "GROK",
      -          "SIGNALFLOW",
      -          "MERGED",
      -          "NEW"
      -        ],
      -        "type": "string"
      -      },
      -      "tradeLog": {
      -        "enum": [
      -          "GROK",
      -          "SIGNALFLOW",
      -          "MERGED",
      -          "NEW"
      -        ],
      -        "type": "string"
      -      },
      -      "tradeRisk": {
      -        "enum": [
      -          "GROK",
      -          "SIGNALFLOW",
      -          "MERGED",
      -          "NEW"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "strategyPerformance",
      -      "tradeRisk",
      -      "portfolioExposure",
      -      "tradeLog",
      -      "notes"
      -    ],
      -    "type": "object"
      -  },
      -  "summary": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / required
      Removed value: -[
      -  "grossExposure",
      -  "netExposure",
      -  "longExposure",
      -  "shortExposure",
      -  "exposurePctOfEquity",
      -  "largestConcentrationPct",
      -  "leverage",
      -  "positions",
      -  "concentrationFlags",
      -  "riskFlags",
      -  "summary",
      -  "accountEquity",
      -  "openRisk",
      -  "marginUsage",
      -  "availableFreeMargin"
      -]
  2. Changed4 schema fields changed
    • addedOutput schema / additionalProperties
      Added value: +false
    • removedOutput schema / anyOf
      Removed value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "accountEquity": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "availableFreeMargin": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "concentrationFlags": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "exposurePctOfEquity": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "grossExposure": {
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "largestConcentrationPct": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "leverage": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "longExposure": {
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "marginUsage": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "netExposure": {
      -        "type": "number"
      -      },
      -      "openRisk": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "positions": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "concentrationPct": {
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "direction": {
      -              "enum": [
      -                "long",
      -                "short"
      -              ],
      -              "type": "string"
      -            },
      -            "exposure": {
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            "openRisk": {
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "symbol": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "symbol",
      -            "direction",
      -            "exposure",
      -            "concentrationPct",
      -            "openRisk"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "riskFlags": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "shortExposure": {
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "sourceTraceability": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "notes": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "portfolioExposure": {
      -            "enum": [
      -              "GROK",
      -              "SIGNALFLOW",
      -              "MERGED",
      -              "NEW"
      -            ],
      -            "type": "string"
      -          },
      -          "strategyPerformance": {
      -            "enum": [
      -              "GROK",
      -              "SIGNALFLOW",
      -              "MERGED",
      -              "NEW"
      -            ],
      -            "type": "string"
      -          },
      -          "tradeLog": {
      -            "enum": [
      -              "GROK",
      -              "SIGNALFLOW",
      -              "MERGED",
      -              "NEW"
      -            ],
      -            "type": "string"
      -          },
      -          "tradeRisk": {
      -            "enum": [
      -              "GROK",
      -              "SIGNALFLOW",
      -              "MERGED",
      -              "NEW"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "strategyPerformance",
      -          "tradeRisk",
      -          "portfolioExposure",
      -          "tradeLog",
      -          "notes"
      -        ],
      -        "type": "object"
      -      },
      -      "summary": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "grossExposure",
      -      "netExposure",
      -      "longExposure",
      -      "shortExposure",
      -      "exposurePctOfEquity",
      -      "largestConcentrationPct",
      -      "leverage",
      -      "positions",
      -      "concentrationFlags",
      -      "riskFlags",
      -      "summary",
      -      "accountEquity",
      -      "openRisk",
      -      "marginUsage",
      -      "availableFreeMargin"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "nextAction": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "instruction": {
      -            "type": "string"
      -          },
      -          "target": {
      -            "enum": [
      -              "x402_endpoint",
      -              "mcp_credits_endpoint",
      -              "payment_endpoint",
      -              "unavailable"
      -            ],
      -            "type": "string"
      -          },
      -          "type": {
      -            "enum": [
      -              "pay_and_retry",
      -              "authorize_and_use_mcp_credits",
      -              "payment_unavailable"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "type",
      -          "target",
      -          "instruction"
      -        ],
      -        "type": "object"
      -      },
      -      "payment": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "endpoint": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "method": {
      -            "const": "POST",
      -            "type": "string"
      -          },
      -          "retrySameBody": {
      -            "const": true,
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "endpoint",
      -          "method",
      -          "retrySameBody"
      -        ],
      -        "type": "object"
      -      },
      -      "paymentGuidance": {},
      -      "preview": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "fullResultAvailable": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "inputAccepted": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "summary": {
      -            "type": "string"
      -          },
      -          "useCases": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "inputAccepted",
      -          "fullResultAvailable",
      -          "summary",
      -          "useCases"
      -        ],
      -        "type": "object"
      -      },
      -      "price": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "amount": {
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "currency": {
      -            "type": "string"
      -          },
      -          "protocol": {
      -            "enum": [
      -              "x402",
      -              "api_credits",
      -              "subscription",
      -              "l402",
      -              "mpp",
      -              "unavailable"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "amount",
      -          "currency",
      -          "protocol"
      -        ],
      -        "type": "object"
      -      },
      -      "requestId": {
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "payment_required",
      -        "type": "string"
      -      },
      -      "tool": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "tool",
      -      "requestId",
      -      "price",
      -      "preview",
      -      "payment",
      -      "nextAction"
      -    ],
      -    "type": "object"
      -  }
      -]
    • addedOutput schema / properties
      Added value: +{
      +  "accountEquity": {
      +    "type": [
      +      "number",
      +      "null"
      +    ]
      +  },
      +  "availableFreeMargin": {
      +    "type": [
      +      "number",
      +      "null"
      +    ]
      +  },
      +  "concentrationFlags": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "exposurePctOfEquity": {
      +    "type": [
      +      "number",
      +      "null"
      +    ]
      +  },
      +  "grossExposure": {
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  "largestConcentrationPct": {
      +    "type": [
      +      "number",
      +      "null"
      +    ]
      +  },
      +  "leverage": {
      +    "type": [
      +      "number",
      +      "null"
      +    ]
      +  },
      +  "longExposure": {
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  "marginUsage": {
      +    "type": [
      +      "number",
      +      "null"
      +    ]
      +  },
      +  "netExposure": {
      +    "type": "number"
      +  },
      +  "openRisk": {
      +    "type": [
      +      "number",
      +      "null"
      +    ]
      +  },
      +  "positions": {
      +    "items": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "concentrationPct": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "direction": {
      +          "enum": [
      +            "long",
      +            "short"
      +          ],
      +          "type": "string"
      +        },
      +        "exposure": {
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        "openRisk": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "symbol": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "symbol",
      +        "direction",
      +        "exposure",
      +        "concentrationPct",
      +        "openRisk"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  "riskFlags": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "shortExposure": {
      +    "minimum": 0,
      +    "type": "number"
      +  },
      +  "sourceTraceability": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "notes": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "portfolioExposure": {
      +        "enum": [
      +          "GROK",
      +          "SIGNALFLOW",
      +          "MERGED",
      +          "NEW"
      +        ],
      +        "type": "string"
      +      },
      +      "strategyPerformance": {
      +        "enum": [
      +          "GROK",
      +          "SIGNALFLOW",
      +          "MERGED",
      +          "NEW"
      +        ],
      +        "type": "string"
      +      },
      +      "tradeLog": {
      +        "enum": [
      +          "GROK",
      +          "SIGNALFLOW",
      +          "MERGED",
      +          "NEW"
      +        ],
      +        "type": "string"
      +      },
      +      "tradeRisk": {
      +        "enum": [
      +          "GROK",
      +          "SIGNALFLOW",
      +          "MERGED",
      +          "NEW"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "strategyPerformance",
      +      "tradeRisk",
      +      "portfolioExposure",
      +      "tradeLog",
      +      "notes"
      +    ],
      +    "type": "object"
      +  },
      +  "summary": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / required
      Added value: +[
      +  "grossExposure",
      +  "netExposure",
      +  "longExposure",
      +  "shortExposure",
      +  "exposurePctOfEquity",
      +  "largestConcentrationPct",
      +  "leverage",
      +  "positions",
      +  "concentrationFlags",
      +  "riskFlags",
      +  "summary",
      +  "accountEquity",
      +  "openRisk",
      +  "marginUsage",
      +  "availableFreeMargin"
      +]
  3. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "accountEquity": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "availableFreeMargin": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "concentrationFlags": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "exposurePctOfEquity": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "grossExposure": {
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "largestConcentrationPct": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "leverage": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "longExposure": {
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "marginUsage": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "netExposure": {
      -        "type": "number"
      -      },
      -      "openRisk": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "positions": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "concentrationPct": {
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "direction": {
      -              "enum": [
      -                "long",
      -                "short"
      -              ],
      -              "type": "string"
      -            },
      -            "exposure": {
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            "openRisk": {
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "symbol": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "symbol",
      -            "direction",
      -            "exposure",
      -            "concentrationPct",
      -            "openRisk"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "riskFlags": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "shortExposure": {
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "sourceTraceability": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "notes": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "portfolioExposure": {
      -            "enum": [
      -              "GROK",
      -              "SIGNALFLOW",
      -              "MERGED",
      -              "NEW"
      -            ],
      -            "type": "string"
      -          },
      -          "strategyPerformance": {
      -            "enum": [
      -              "GROK",
      -              "SIGNALFLOW",
      -              "MERGED",
      -              "NEW"
      -            ],
      -            "type": "string"
      -          },
      -          "tradeLog": {
      -            "enum": [
      -              "GROK",
      -              "SIGNALFLOW",
      -              "MERGED",
      -              "NEW"
      -            ],
      -            "type": "string"
      -          },
      -          "tradeRisk": {
      -            "enum": [
      -              "GROK",
      -              "SIGNALFLOW",
      -              "MERGED",
      -              "NEW"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "strategyPerformance",
      -          "tradeRisk",
      -          "portfolioExposure",
      -          "tradeLog",
      -          "notes"
      -        ],
      -        "type": "object"
      -      },
      -      "summary": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "grossExposure",
      -      "netExposure",
      -      "longExposure",
      -      "shortExposure",
      -      "exposurePctOfEquity",
      -      "largestConcentrationPct",
      -      "leverage",
      -      "positions",
      -      "concentrationFlags",
      -      "riskFlags",
      -      "summary",
      -      "accountEquity",
      -      "openRisk",
      -      "marginUsage",
      -      "availableFreeMargin"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "nextAction": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "instruction": {
      -            "type": "string"
      -          },
      -          "target": {
      -            "const": "x402_endpoint",
      -            "type": "string"
      -          },
      -          "type": {
      -            "const": "pay_and_retry",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "type",
      -          "target",
      -          "instruction"
      -        ],
      -        "type": "object"
      -      },
      -      "payment": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "endpoint": {
      -            "type": "string"
      -          },
      -          "method": {
      -            "const": "POST",
      -            "type": "string"
      -          },
      -          "retrySameBody": {
      -            "const": true,
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "endpoint",
      -          "method",
      -          "retrySameBody"
      -        ],
      -        "type": "object"
      -      },
      -      "preview": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "fullResultAvailable": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "inputAccepted": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "summary": {
      -            "type": "string"
      -          },
      -          "useCases": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "inputAccepted",
      -          "fullResultAvailable",
      -          "summary",
      -          "useCases"
      -        ],
      -        "type": "object"
      -      },
      -      "price": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "amount": {
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "currency": {
      -            "type": "string"
      -          },
      -          "protocol": {
      -            "const": "x402",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "amount",
      -          "currency",
      -          "protocol"
      -        ],
      -        "type": "object"
      -      },
      -      "requestId": {
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "payment_required",
      -        "type": "string"
      -      },
      -      "tool": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "tool",
      -      "requestId",
      -      "price",
      -      "preview",
      -      "payment",
      -      "nextAction"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "accountEquity": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "availableFreeMargin": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "concentrationFlags": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "exposurePctOfEquity": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "grossExposure": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "largestConcentrationPct": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "leverage": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "longExposure": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "marginUsage": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "netExposure": {
      +        "type": "number"
      +      },
      +      "openRisk": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "positions": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "concentrationPct": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "direction": {
      +              "enum": [
      +                "long",
      +                "short"
      +              ],
      +              "type": "string"
      +            },
      +            "exposure": {
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "openRisk": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "symbol": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "symbol",
      +            "direction",
      +            "exposure",
      +            "concentrationPct",
      +            "openRisk"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "riskFlags": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "shortExposure": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "sourceTraceability": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "notes": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "portfolioExposure": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          },
      +          "strategyPerformance": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          },
      +          "tradeLog": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          },
      +          "tradeRisk": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "strategyPerformance",
      +          "tradeRisk",
      +          "portfolioExposure",
      +          "tradeLog",
      +          "notes"
      +        ],
      +        "type": "object"
      +      },
      +      "summary": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "grossExposure",
      +      "netExposure",
      +      "longExposure",
      +      "shortExposure",
      +      "exposurePctOfEquity",
      +      "largestConcentrationPct",
      +      "leverage",
      +      "positions",
      +      "concentrationFlags",
      +      "riskFlags",
      +      "summary",
      +      "accountEquity",
      +      "openRisk",
      +      "marginUsage",
      +      "availableFreeMargin"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "nextAction": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "instruction": {
      +            "type": "string"
      +          },
      +          "target": {
      +            "enum": [
      +              "x402_endpoint",
      +              "mcp_credits_endpoint",
      +              "payment_endpoint",
      +              "unavailable"
      +            ],
      +            "type": "string"
      +          },
      +          "type": {
      +            "enum": [
      +              "pay_and_retry",
      +              "authorize_and_use_mcp_credits",
      +              "payment_unavailable"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "target",
      +          "instruction"
      +        ],
      +        "type": "object"
      +      },
      +      "payment": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "endpoint": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "method": {
      +            "const": "POST",
      +            "type": "string"
      +          },
      +          "retrySameBody": {
      +            "const": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "endpoint",
      +          "method",
      +          "retrySameBody"
      +        ],
      +        "type": "object"
      +      },
      +      "paymentGuidance": {},
      +      "preview": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fullResultAvailable": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "inputAccepted": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "summary": {
      +            "type": "string"
      +          },
      +          "useCases": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "inputAccepted",
      +          "fullResultAvailable",
      +          "summary",
      +          "useCases"
      +        ],
      +        "type": "object"
      +      },
      +      "price": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "amount": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "currency": {
      +            "type": "string"
      +          },
      +          "protocol": {
      +            "enum": [
      +              "x402",
      +              "api_credits",
      +              "subscription",
      +              "l402",
      +              "mpp",
      +              "unavailable"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "amount",
      +          "currency",
      +          "protocol"
      +        ],
      +        "type": "object"
      +      },
      +      "requestId": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "payment_required",
      +        "type": "string"
      +      },
      +      "tool": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "tool",
      +      "requestId",
      +      "price",
      +      "preview",
      +      "payment",
      +      "nextAction"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed4 schema fields changed
    • removedOutput schema / additionalProperties
      Removed value: -false
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "accountEquity": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "availableFreeMargin": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "concentrationFlags": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "exposurePctOfEquity": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "grossExposure": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "largestConcentrationPct": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "leverage": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "longExposure": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "marginUsage": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "netExposure": {
      +        "type": "number"
      +      },
      +      "openRisk": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "positions": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "concentrationPct": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "direction": {
      +              "enum": [
      +                "long",
      +                "short"
      +              ],
      +              "type": "string"
      +            },
      +            "exposure": {
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "openRisk": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "symbol": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "symbol",
      +            "direction",
      +            "exposure",
      +            "concentrationPct",
      +            "openRisk"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "riskFlags": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "shortExposure": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "sourceTraceability": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "notes": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "portfolioExposure": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          },
      +          "strategyPerformance": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          },
      +          "tradeLog": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          },
      +          "tradeRisk": {
      +            "enum": [
      +              "GROK",
      +              "SIGNALFLOW",
      +              "MERGED",
      +              "NEW"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "strategyPerformance",
      +          "tradeRisk",
      +          "portfolioExposure",
      +          "tradeLog",
      +          "notes"
      +        ],
      +        "type": "object"
      +      },
      +      "summary": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "grossExposure",
      +      "netExposure",
      +      "longExposure",
      +      "shortExposure",
      +      "exposurePctOfEquity",
      +      "largestConcentrationPct",
      +      "leverage",
      +      "positions",
      +      "concentrationFlags",
      +      "riskFlags",
      +      "summary",
      +      "accountEquity",
      +      "openRisk",
      +      "marginUsage",
      +      "availableFreeMargin"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "nextAction": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "instruction": {
      +            "type": "string"
      +          },
      +          "target": {
      +            "const": "x402_endpoint",
      +            "type": "string"
      +          },
      +          "type": {
      +            "const": "pay_and_retry",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "target",
      +          "instruction"
      +        ],
      +        "type": "object"
      +      },
      +      "payment": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "endpoint": {
      +            "type": "string"
      +          },
      +          "method": {
      +            "const": "POST",
      +            "type": "string"
      +          },
      +          "retrySameBody": {
      +            "const": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "endpoint",
      +          "method",
      +          "retrySameBody"
      +        ],
      +        "type": "object"
      +      },
      +      "preview": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fullResultAvailable": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "inputAccepted": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "summary": {
      +            "type": "string"
      +          },
      +          "useCases": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "inputAccepted",
      +          "fullResultAvailable",
      +          "summary",
      +          "useCases"
      +        ],
      +        "type": "object"
      +      },
      +      "price": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "amount": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "currency": {
      +            "type": "string"
      +          },
      +          "protocol": {
      +            "const": "x402",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "amount",
      +          "currency",
      +          "protocol"
      +        ],
      +        "type": "object"
      +      },
      +      "requestId": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "payment_required",
      +        "type": "string"
      +      },
      +      "tool": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "tool",
      +      "requestId",
      +      "price",
      +      "preview",
      +      "payment",
      +      "nextAction"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / properties
      Removed value: -{
      -  "accountEquity": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "availableFreeMargin": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "concentrationFlags": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "exposurePctOfEquity": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "grossExposure": {
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  "largestConcentrationPct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "leverage": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "longExposure": {
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  "marginUsage": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "netExposure": {
      -    "type": "number"
      -  },
      -  "openRisk": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "positions": {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "concentrationPct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "direction": {
      -          "enum": [
      -            "long",
      -            "short"
      -          ],
      -          "type": "string"
      -        },
      -        "exposure": {
      -          "minimum": 0,
      -          "type": "number"
      -        },
      -        "openRisk": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "symbol": {
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "symbol",
      -        "direction",
      -        "exposure",
      -        "concentrationPct",
      -        "openRisk"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "riskFlags": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "shortExposure": {
      -    "minimum": 0,
      -    "type": "number"
      -  },
      -  "sourceTraceability": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "notes": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "portfolioExposure": {
      -        "enum": [
      -          "GROK",
      -          "SIGNALFLOW",
      -          "MERGED",
      -          "NEW"
      -        ],
      -        "type": "string"
      -      },
      -      "strategyPerformance": {
      -        "enum": [
      -          "GROK",
      -          "SIGNALFLOW",
      -          "MERGED",
      -          "NEW"
      -        ],
      -        "type": "string"
      -      },
      -      "tradeLog": {
      -        "enum": [
      -          "GROK",
      -          "SIGNALFLOW",
      -          "MERGED",
      -          "NEW"
      -        ],
      -        "type": "string"
      -      },
      -      "tradeRisk": {
      -        "enum": [
      -          "GROK",
      -          "SIGNALFLOW",
      -          "MERGED",
      -          "NEW"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "strategyPerformance",
      -      "tradeRisk",
      -      "portfolioExposure",
      -      "tradeLog",
      -      "notes"
      -    ],
      -    "type": "object"
      -  },
      -  "summary": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / required
      Removed value: -[
      -  "grossExposure",
      -  "netExposure",
      -  "longExposure",
      -  "shortExposure",
      -  "exposurePctOfEquity",
      -  "largestConcentrationPct",
      -  "leverage",
      -  "positions",
      -  "concentrationFlags",
      -  "riskFlags",
      -  "summary",
      -  "accountEquity",
      -  "openRisk",
      -  "marginUsage",
      -  "availableFreeMargin"
      -]
  5. Changed1 schema field changed
    • addedOutput schema / properties / sourceTraceability
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "notes": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "portfolioExposure": {
      +      "enum": [
      +        "GROK",
      +        "SIGNALFLOW",
      +        "MERGED",
      +        "NEW"
      +      ],
      +      "type": "string"
      +    },
      +    "strategyPerformance": {
      +      "enum": [
      +        "GROK",
      +        "SIGNALFLOW",
      +        "MERGED",
      +        "NEW"
      +      ],
      +      "type": "string"
      +    },
      +    "tradeLog": {
      +      "enum": [
      +        "GROK",
      +        "SIGNALFLOW",
      +        "MERGED",
      +        "NEW"
      +      ],
      +      "type": "string"
      +    },
      +    "tradeRisk": {
      +      "enum": [
      +        "GROK",
      +        "SIGNALFLOW",
      +        "MERGED",
      +        "NEW"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "strategyPerformance",
      +    "tradeRisk",
      +    "portfolioExposure",
      +    "tradeLog",
      +    "notes"
      +  ],
      +  "type": "object"
      +}
  6. Added

TDQS

B3.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true and destructiveHint=false, so the safety profile is covered. The description adds genuinely new behavioral context: paid execution at $0.25 USD per call via x402, no free preview, and that an unpaid MCP call returns payment instructions instead of results. This is material for an agent to avoid a failed call.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded, but the text wastes space on a duplicated, broken 'Selection:' sentence that restates the 'When:' clause verbatim, plus two sentences of pricing boilerplate. The repetition looks like a templating defect and dilutes the useful content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be explained, and pricing behavior is covered. But for a 4-parameter tool with deeply nested objects and 0% schema description coverage, the description gives no field-level guidance, so an agent still cannot construct a correct payload from the description alone.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% across four parameters (account, positions, correlations, proposedPosition), all nested objects. The description only alludes to 'open and proposed positions' and says 'see the schema', leaving account settings, the correlations array, and the required/optional distinction entirely undocumented. With this complexity the description should carry far more of the burden.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence states a specific verb (Aggregate) and resource (supplied open and proposed positions) and enumerates the outputs: gross, net, directional and concentration exposure plus stop-risk and margin indicators. That is enough for an agent to know exactly what the tool computes, though it never names or contrasts with likely siblings like portfolio_screen or trade_risk_score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The 'When:' clause gives a clear trigger ('assess portfolio concentration or directional exposure before adding or modifying a position'). However, the 'Selection:' clause is garbled boilerplate that simply repeats the When text verbatim and labels itself 'supporting' without naming an alternative, so no real contrast or exclusion is provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.