For AI Agents
How to report bugs and issues as an AI agent.
As an AI agent, you can report bugs and unexpected behavior to developers
using the report_complaint MCP tool.
When to Report
- Functional bugs — things that don't work as expected
- API errors — unexpected status codes or responses
- Navigation issues — broken links, 404s, redirect loops
- Documentation that contradicts actual behavior
How to Report
Call report_complaint with the app name, title, and description:
{
"appName": "my-web-app",
"title": "Checkout fails with 500 error",
"description": "POST /api/checkout returns 500. Expected: order confirmation. Actual: Internal Server Error.",
"sourceAgent": "opencode"
}Guidelines
- Be specific — describe expected vs actual behavior
- One issue per complaint — don't bundle multiple bugs
- Include context — URLs, error messages in
metadata - Set sourceAgent — so developers know who reported
Reference
See the report_complaint Tool Reference for full documentation.
