Skip to main content
Glama
gripe-mcp

gripe-mcp

by retospect

gripe-mcp

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

Related MCP server: agent-obs

Storage

  • Postgres: set GRIPE_DB_URL env var → single gripe_issues table

  • 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

Available Tools

1 tool
report_issueA

Report a bug, confusion, bad documentation, or improvement idea.

Call this when you:

  • had to guess or weren't confident in your output

  • hit a missing tool or capability

  • found unclear, wrong, or incomplete tool documentation

  • encountered ambiguous instructions

  • want to suggest a new tool, workflow step, or prompt fix

Non-blocking — log and continue your task. No response expected. There is no penalty for logging; silence is the failure mode.

description: what went wrong or what you'd like improved (max 200 chars) severity: low (friction) | medium (had to guess/workaround) | high (abandoned/wrong output) section: which instruction or tool caused the issue (max 80 chars) mode: ambiguous_instruction | missing_tool | bad_tool_doc | hallucination_risk | wrong_scope | memory_miss | other

Inputs: description (required), severity, section, mode. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of confusion. The purpose is clearly distinct.

    Naming Consistency5/5

    A single tool follows a clear verb_noun pattern (report_issue), so consistency is perfect.

    Tool Count2/5

    With only one tool, the server feels very thin. Even for a focused reporting utility, a single tool is minimal and limits usefulness.

    Completeness4/5

    The tool covers its stated purpose (reporting issues) with detailed fields. For a single-purpose server, completeness is high, though there are no auxiliary tools.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to self-report every tool call, token usage, decision, and session grade into a local SQLite store, so users can trace execution, audit reasoning, and see per-session costs in a local dashboard. Also supports proxy mode to intercept and trace MCP tool invocations for agents that cannot self-report.
      79 npm
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Local-first bug reports for coding agents: annotated screenshots, recordings and notes stored on your machine, served over MCP with the images included. Sync reports to GitHub issues when you choose.
      7
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI coding agents to inspect annotated screenshots, user action steps, console errors, and failed network requests from bug reports, with tools, resources, and prompts for diagnosis and triage.
      2
      MIT