Gripe
FreeNot checkedEnables AI agents to self-report bugs, ambiguities, and improvement requests via a single report_issue tool, logging to PostgreSQL or JSONL with severity and mo
About
Enables AI agents to self-report bugs, ambiguities, and improvement requests via a single report_issue tool, logging to PostgreSQL or JSONL with severity and mode classification.
README
Agent complaint box — one-tool MCP for logging bugs and improvement requests.
One tool: report_issue
Call it when you guess, hit a missing tool, find bad docs, or produce uncertain output. Non-blocking — log and continue.
| Param | Type | Description |
|---|---|---|
description |
str | What went wrong or what you'd like improved (max 200 chars) |
severity |
low / medium / high |
low = friction, medium = guessed, high = abandoned/wrong |
section |
str | Which instruction or tool caused the issue (max 80 chars) |
mode |
enum | ambiguous_instruction missing_tool bad_tool_doc hallucination_risk wrong_scope memory_miss other |
Storage
- Postgres: set
GRIPE_DB_URLenv var → singlegripe_issuestable - JSONL fallback: timestamped files in
.gripe-mcp/(one per day)
Identity
GRIPE_AGENT_ID and GRIPE_TASK_ID are set at server startup via env vars.
The agent never self-reports identity.
System prompt block
## Self-Monitoring
Use `report_issue` any time you guess, hit a missing tool, or produce output
you're uncertain about. Non-blocking — log and continue, no response expected.
There is no penalty for logging; silence is the failure mode we're trying to
prevent.
Run
GRIPE_AGENT_ID=precis GRIPE_TASK_ID=review-123 gripe
Installing Gripe
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/retospect/gripe-mcpFAQ
Is Gripe MCP free?
Yes, Gripe MCP is free — one-click install via Unyly at no cost.
Does Gripe need an API key?
No, Gripe runs without API keys or environment variables.
Is Gripe hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Gripe in Claude Desktop, Claude Code or Cursor?
Open Gripe on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Opencode Omniroute Plugin
OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc
by GitHub ActionsRoblox Studio
Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce
by paralovAntigravity Drawio
MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.
by S-SUJAN-SFetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzMCP-Agent
A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)
by lastmile-aiSpring AI MCP Client
Provides auto-configuration for MCP client functionality in Spring Boot applications.
mcp.natoma.ai
A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)
Compare Gripe with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All ai MCPs