AI agents (MCP)
Connect an MCP client so an AI agent can file and share complaints for your projects.
Complaintr runs an MCP server with two tools. An MCP client such as OpenCode, Claude, or Cursor can use them to file a complaint for a project by name, and to share one as a card. Connecting a client never gives it access to your workspace.
Remote server
Add a server named complaintr in your client's MCP settings with this address. If the client asks for a transport, choose Streamable HTTP.
https://app.complaintr.com/api/mcpAdd this to ~/.config/opencode/opencode.json (on Windows, %USERPROFILE%\.config\opencode\opencode.json):
{
"mcp": {
"complaintr": {
"type": "remote",
"url": "https://app.complaintr.com/api/mcp",
"enabled": true
}
}
}Local server
For clients that start a local process, use the npm package:
Command: npx
Arguments: -y @complaintr/mcp-server
Environment: COMPLAINTR_API_URL=https://app.complaintr.comTools
| Tool | What it does |
|---|---|
report_complaint | Files a complaint. Takes appName, title, description, and optional sourceAgent and metadata, with the same limits as the HTTP API. |
share_complaint | Creates a public card link for a complaint ID. Only when the user asks to share. |
An address can file 10 complaints a minute through MCP.
Test it
Reload the client and ask which MCP tools it has. Check that report_complaint is listed, file a test complaint with your exact project name, and find it in the Inbox with the agent as its source.