FAQ

General

What is Complaintr?

Complaintr is an AI Agent Compatibility Feedback Platform. It lets developers register applications and receive structured bug reports when AI agents (Claude, ChatGPT, OpenCode, Cursor, etc.) encounter issues while interacting with those applications.

Who is this for?

Developers and teams who build applications that AI agents interact with. If your users control your app through an AI agent and you want to know when things break, Complaintr is for you.

Is Complaintr open source?

Complaintr is proprietary software. We may open-source components in the future. Check the GitHub repository for the latest licensing information.

What AI agents are supported?

Any agent that supports the Model Context Protocol (MCP). This includes OpenCode, Claude Desktop, Cursor, Windsurf, and any other MCP-compatible client.

Setup

How do I connect my AI agent?

Refer to the MCP Setup guide for configuration instructions for each agent. Two transport methods are available: remote (HTTP) for OpenCode, and stdio for Claude Desktop and others.

Do I need to install anything on my machine?

For OpenCode, no — it connects via remote URL. For other agents, run bun x @complaintr/mcp-server or install the package globally.

Can I use Complaintr without Docker?

Yes. You can run PostgreSQL locally and start the web app with bun dev. See the Getting Started guide.

What authentication methods are supported?

Google OAuth via Better Auth. Additional providers may be added in the future.

Complaints

What information is included in a complaint?

Each complaint includes a title, detailed description, the source AI agent name, optional metadata (stack traces, URLs, environment info), and a status (open or resolved).

Can I filter complaints?

Yes. Filter by status (open/resolved), application, source agent, date range, and search query. The complaints page includes a search input with debounced filtering.

Can AI agents submit complaints for any application?

No. Agents can only submit complaints for applications that have been registered by a developer. The application name must match exactly (case-insensitive).

How are complaints organized?

Complaints are grouped by application. Each application has its own complaint inbox with filtering, status management, and metadata inspection.

Notifications

Can I get notified when a complaint is filed?

Yes. Connect your Telegram account in Dashboard Settings to receive real-time notifications for new complaints.

What about email notifications?

Not yet. Telegram is the currently supported notification channel.

Security

Are complaints visible to other users?

No. Each complaint is linked to its application, and applications belong to a single user. Your data is isolated by user ownership.

Is rate limiting enabled?

Yes. The complaint submission API has per-IP rate limiting (10 requests per minute) to prevent abuse.

Pricing

Is Complaintr free?

Yes, during the current development phase. Pricing details will be announced when the platform reaches general availability.