ComplaintrComplaintr

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.

On this page