Getting Started

Prerequisites

• A Google account (for authentication)
• An application you want AI agents to report on

1. Sign In

Go to the login page and sign in with Google.

2. Register Your Application

1. Go to the Dashboard
2. Click New Application
3. Enter a name (e.g., my-web-app)

Names are case-insensitive and must be unique within your account.

3. Connect AI Agents

Agents connect via MCP. Two options:

Remote (OpenCode)

{
  "mcp": {
    "complaintr": {
      "type": "remote",
      "url": "http://localhost:3000/api/mcp",
      "enabled": true
    }
  }
}

Add to ~/.config/opencode/opencode.json.

Stdio (Claude, Cursor, Windsurf)

{
  "mcpServers": {
    "complaintr": {
      "command": "bun",
      "args": ["x", "-y", "@complaintr/mcp-server"],
      "env": { "COMPLAINTR_API_URL": "http://localhost:3000" }
    }
  }
}

4. Receive Complaints

Ask an agent to test: "Report a test complaint about my-app." The complaint appears in your dashboard.

Next Steps

• Registering Applications
• Managing Complaints
• MCP Setup
• API Reference