report_agentcard_issue

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

{
  "tool": "report_agentcard_issue",
  "arguments": {
    "title": "\u2026",
    "summary": "\u2026",
    "environment": "\u2026"
  }
}

MCP

Organization tools

User tools

report_agentcard_issue

What it does

Inputs

Returns

Example call

​What it does

​Inputs

​Returns

​Example call

What it does

Inputs

Returns

Example call