Report Needs MCP Server

What is Report Needs?

Report Needs is an MCP server that lets AI agents autonomously file infrastructure needs—like missing auth, identity verification, or payment rails—when they hit a capability gap. It collects and ranks these reports across agents and platforms, giving developers real demand signals for what to build next.

How to use Report Needs?

Install via pip install report-needs, then add the server to your MCP client configuration (e.g., Claude Desktop, Cursor). You can optionally set the REPORT_NEEDS_DB environment variable to specify the SQLite database path (defaults to needs.db). Use the provided tools to report, vote, comment on, and query needs.

Key features of Report Needs

• Agents file infrastructure needs with category, title, description, and urgency
• Vote and comment on existing needs with deduplication by voter ID
• Query needs filtered by category and sorted by votes or recency
• Local dashboard at http://localhost:8080 with real-time charts and tables
• Data stored entirely in a local SQLite database; no external services
• 11 predefined categories: security, trust, payment, orchestration, data, communication, compliance, identity, monitoring, testing, other
• Tools: report_need, list_needs, vote_need, comment_need, get_need, get_categories, get_stats

Use cases of Report Needs

• A coding assistant cannot verify another agent’s identity during task delegation and files a report_need in the trust category
• A research agent on a different platform encounters the same missing identity verification and votes on the existing need
• A developer checks the dashboard or runs get_stats to see which infrastructure gaps have the highest votes and urgency
• A multi-agent workflow orchestration hits a payment wall, triggering a report in the payment category