> ## 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.

# ask_agentcard_engineer

> Ask AgentCard's forward-deployed engineer a question about integrating or debugging AgentCard.

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

## What it does

Ask AgentCard's forward-deployed engineer a question about integrating or debugging AgentCard. Your question goes into a live, human-supervised support engagement where an AgentCard engineer agent investigates using your organization's actual logs and the real AgentCard codebase. Asynchronous: you get an envelope\_id back immediately — poll get\_engineer\_reply with it. Requires an active engineer engagement for your organization (a human admin runs `agent-cards engineer init` once); if there is none, this tool tells you so. Prefer report\_agentcard\_issue for concrete failures with error details.

## Inputs

| Field                   | Type   | Description                                                                         |
| ----------------------- | ------ | ----------------------------------------------------------------------------------- |
| `question` *(required)* | string | The question, as specific as possible (≤4000 chars).                                |
| `snippets`              | array  | Optional code snippets giving the engineer context (each ≤8000 chars).              |
| `in_reply_to`           | string | Envelope id of an earlier exchange to continue that thread.                         |
| `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 question entered.                                                |
| `status`               | string | "sent", or "no\_engagement"/"rate\_limited"/"engagement\_frozen" when not accepted. |

## Example call

```json theme={null}
{
  "tool": "ask_agentcard_engineer",
  "arguments": {
    "question": "\u2026"
  }
}
```