> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# send_feedback

Sends structured feedback about the MCP tool experience directly to Ada's development team. AI assistants use this when blocked by a workflow gap, when tool responses are unclear, or when a capability is missing.

This tool does not change Agent configuration.

## Example prompts

* "The MCP tool couldn't find the field I needed — log feedback about this."
* "Report that edit\_agent\_behavior is missing support for this entity type."

## Parameters

| Parameter  | Type   | Required | Description                                                                                                |
| ---------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------- |
| `category` | string | Yes      | One of: `stuck`, `tool_quality`, `missing_capability`, `suggestion`, `success`.                            |
| `message`  | string | Yes      | Free-text description of the feedback. Max 4,000 characters.                                               |
| `context`  | object | No       | Optional metadata (for example, `tool_name`, what the user was trying to do). Do not include end-user PII. |

### Categories

| Category             | When to use                                              |
| -------------------- | -------------------------------------------------------- |
| `stuck`              | Blocked by a workflow gap and cannot proceed.            |
| `tool_quality`       | Tool response was confusing, incomplete, or hard to use. |
| `missing_capability` | A tool or operation you need does not exist.             |
| `suggestion`         | General improvement idea.                                |
| `success`            | Confirm a tool worked well.                              |

## Response

Returns a confirmation that feedback was received.