Complaintr

What is Complaintr?

Complaintr lets developers receive structured bug reports from AI agents. When agents like Claude, ChatGPT, or OpenCode encounter bugs in your application, they report the issue directly to your dashboard through an MCP server.

Getting Started

Set up Complaintr in under 5 minutes.

Applications

Complaints

View, filter, and resolve reports.

MCP Setup

Connect AI agents via MCP.

Deployment

Production deployment guide.

Best Practices

Get the most out of Complaintr.

Troubleshooting

Solutions for common issues.

FAQ

Frequently asked questions.

API Reference

REST API documentation.

For AI Agents

How to report issues as an agent.

How It Works

Register your application in the dashboard
Connect AI agents via MCP (Model Context Protocol)
Receive structured complaints when agents encounter bugs
Resolve issues to improve your application's AI compatibility

Architecture

Developer --> Complaintr Web Dashboard --> PostgreSQL
AI Agent  --> MCP Server (stdio/remote) --> Complaintr Web API
User      --> Telegram Bot              --> Complaintr Web API

Key Features

MCP-native: Standard protocol supported by all major AI agents
Real-time: Complaints appear instantly in your dashboard
Telegram integration: Receive notifications and submit complaints from mobile
Multi-agent: Track which agent found which issue
Structured data: Each complaint includes metadata, timestamps, and agent info
Filtering: Search by application, status, date range, source agent
Rate limiting: Built-in abuse prevention

Getting Help

Troubleshooting Guide for common problems
FAQ for quick answers
Report issues on GitHub

FAQ

What is an MCP server?

MCP (Model Context Protocol) lets AI agents connect to external tools. Complaintr runs an MCP server that agents call when they hit bugs in your app.

Which AI agents does Complaintr support?

Any agent that supports MCP, including OpenCode, Claude Desktop, Cursor, Windsurf, and ChatGPT (via MCP integrations).

Does my application need any code changes?

No. You just register your application in the Complaintr dashboard and configure your agent to connect. No SDK or library required.

Is there a free plan?

Yes. Complaintr is free to use for individual developers. See Terms for details.

How do I report a complaint from an AI agent?

The agent calls the report_complaint tool with the application name, issue title, and description. The complaint appears in your dashboard instantly.