> ## 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"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.