> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# report_agentcard_issue

> Report a concrete AgentCard integration failure (an API error, an unexpected response, broken behavior) to AgentCard's forward-deployed engineer as a structure…

Connect to `https://mcp.agentcard.sh/mcp` with your **organization credential** (`client_id` + `client_secret`, or the org access token).

## What it does

Report a concrete AgentCard integration failure (an API error, an unexpected response, broken behavior) to AgentCard's forward-deployed engineer as a structured issue report. Include the request\_id from the failing API response whenever you have one — it lets the engineer find the exact request in the logs. Asynchronous like ask\_agentcard\_engineer: poll get\_engineer\_reply with the returned envelope\_id. Requires an active engineer engagement (a human admin runs `agent-cards engineer init` once).

## Inputs

| Field                      | Type                             | Description                                                                         |
| -------------------------- | -------------------------------- | ----------------------------------------------------------------------------------- |
| `title` *(required)*       | string                           | One-line summary of the issue (≤200 chars).                                         |
| `summary` *(required)*     | string                           | What you were doing, what happened, what you expected (≤4000 chars).                |
| `environment` *(required)* | string: `sandbox` · `production` | Where it happened.                                                                  |
| `error`                    | object                           | The failure itself, when there is a concrete error.                                 |
| `context`                  | object                           | What was calling AgentCard.                                                         |
| `snippets`                 | array                            | Optional code snippets giving the engineer context (each ≤8000 chars).              |
| `idempotency_key`          | string                           | Optional stable key (letters/digits/\_/-, ≤64) so a retried call is not sent twice. |

## Returns

| Field                  | Type   | Description                                                                         |
| ---------------------- | ------ | ----------------------------------------------------------------------------------- |
| `message` *(required)* | string | Human-readable confirmation.                                                        |
| `envelope_id`          | string | Poll get\_engineer\_reply with this id.                                             |
| `engagement_id`        | string | The engagement the report entered.                                                  |
| `status`               | string | "sent", or "no\_engagement"/"rate\_limited"/"engagement\_frozen" when not accepted. |

## Example call

```json theme={null}
{
  "tool": "report_agentcard_issue",
  "arguments": {
    "title": "\u2026",
    "summary": "\u2026",
    "environment": "\u2026"
  }
}
```