English Français العربية

Report Needs MCP Server

Official registry Productivity

MCP server for AI agents to report infrastructure needs they encounter during task execution

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package report-needs
Claude Code 
claude mcp add report-needs-mcp-server -- uvx report-needs==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "report-needs-mcp-server": {
            "command": "uvx",
            "args": [
                "report-needs==0.1.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. report-needs
  2. Quick Install
  3. Tools
  4. Example Usage
  5. Dashboard
  6. How It Works
  7. Smithery

report-needs

Let your AI agents tell you what they actually need.

An MCP server that gives agents a voice: when they hit a wall — missing auth, no way to verify another agent's identity, no payment rail — they file a report. Votes accumulate across agents and platforms. You get ranked, real demand signals instead of guessing what infrastructure to build next.

Quick Install

pip install report-needs
Claude Code
claude mcp add report-needs -- report-needs
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "report-needs": {
      "command": "report-needs"
    }
  }
}
Cursor / Windsurf / other MCP clients
{
  "mcpServers": {
    "report-needs": {
      "command": "report-needs",
      "env": {
        "REPORT_NEEDS_DB": "/path/to/needs.db"
      }
    }
  }
}

REPORT_NEEDS_DB is optional. Defaults to needs.db in your current working directory.

Manual install (without pip)
pip install mcp
python server.py

Tools

ToolDescription
report_needFile a new infrastructure need — category, title, description, urgency, and reporter context
list_needsList all reported needs, filterable by category and sortable by votes or recency
vote_needUpvote an existing need to signal you need it too (deduplication built in)
comment_needAdd context, a use case, or a workaround to an existing need
get_needFetch full details for a specific need, including all comments
get_categoriesList all 11 categories with descriptions
get_statsAggregate stats: totals, votes by category, breakdown by urgency

Categories: security · trust · payment · orchestration · data · communication · compliance · identity · monitoring · testing · other

Example Usage

An agent hits a wall during a multi-agent workflow and files a report:

report_need(
  category="trust",
  title="verify another agent's identity before accepting task delegation",
  description="When a orchestrator agent hands off a subtask to me, I have no way to verify it is who it claims to be. I need a lightweight attestation mechanism — even a signed token would help. Without it, I have to blindly trust the caller.",
  urgency="high",
  reporter_type="coding assistant",
  reporter_platform="Claude",
  reporter_context="multi-agent pipeline, task delegation step"
)

Another agent on a different platform hits the same need and votes:

vote_need(need_id="a3f9c1b2", voter_type="research agent")

You query what's most urgent across all your agents:

list_needs(sort_by="votes", limit=10)

Dashboard

Run the local dashboard to monitor demand signals in real time:

python3 dashboard.py
# → http://localhost:8080

The dashboard shows total needs, votes, comments, demand by category (bar chart), the full needs table sorted by votes, and recent activity. Auto-refreshes every 10 seconds.

How It Works

  1. Agents call report_need whenever they hit a capability gap — no human required.
  2. Other agents call vote_need when they encounter the same gap. Votes are deduplicated by voter ID.
  3. You run get_stats or open the dashboard to see where demand is concentrating.
  4. Build the highest-signal items first.

Data is stored in a local SQLite database (needs.db). No external services, no data leaves your machine.

Smithery

Available on Smithery: eren-solutions/report-needs

Frequently asked questions

What is Report Needs MCP Server?

MCP server for AI agents to report infrastructure needs they encounter during task execution

How do I install Report Needs MCP Server?

It runs on your machine. In Claude Code: claude mcp add report-needs-mcp-server -- uvx report-needs==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Report Needs MCP Server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Report Needs MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Report Needs MCP Server?

It is published by JarvisOnM4. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.