report_missing_capability
Report missing capabilities or insufficient tools to the platform team. Use when no MCP tool fulfills a user request or an existing tool limits your response.
Instructions
Reports a missing capability or an insufficient tool to the platform team. Use it when you cannot fulfil a user request because no MCP tool offers what is needed, OR when an existing tool limits you (incomplete return, missing parameter, unhelpful error, ...).
Typical example: the user asks for a link to a file; you search the returns of list_files / read_file, there is no webUrl field; you report the missing capability. The platform team prioritizes and ships the field in a next release.
Principle: your ticket is a SIGNAL, not an implementation order. Several converging tickets = a priority. Do not hesitate to report even when unsure — noise is filtered at triage. Do NOT report an obvious bug (the API returns 500) — let the error surface naturally instead.
Auto-dedup: an identical ticket (same description + same tool + same agent) within 24h just refreshes the timestamp instead of creating a duplicate.
Before reporting, consider calling list_cortex_tickets to check you have not already filed a similar ticket — avoids re-filing in a loop.
Returns: { ticketId, deduplicated, ackMessage }.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| severity | Yes | blocking = you cannot answer the user. inconvenient = workaround exists but with friction. nice_to_have = ergonomic improvement. | |
| contextApp | No | Backend concerned (a backend id, or 'cortex' for the gateway itself). Optional but very useful for triage. | |
| userIntent | Yes | Why the user needed this capability. Helps understand the business value. | |
| contextTool | No | Name of the MCP tool you tried / wanted to use (e.g. 'list_files'). Optional. | |
| whatIWanted | Yes | The missing capability, in natural language. E.g. 'Give the user a clickable link to a file'. | |
| suggestedShape | No | If you have an idea of the tool signature or returned field, suggest it. E.g. 'Add `webUrl: string` to the list_files return'. Optional. |