{
  "markdown": "# Feedback Synthesis MCP\n\n[![MCP.Directory](https://img.shields.io/badge/MCP.Directory-listed-blue)](https://mcp.directory/servers?q=feedback-synthesis-mcp)\n\n> Customer feedback intelligence for AI agents and developers. Synthesize GitHub Issues, Hacker News threads, and App Store reviews into ranked pain clusters with evidence links. Pay-per-call via x402 micropayments — no signup required.\n\n<!-- mcp-name: io.github.sapph1re/feedback-synthesis-mcp -->\n\nStop reading through hundreds of feedback items manually. Feedback Synthesis MCP collects from multiple sources, runs a multi-pass LLM pipeline, and returns ranked pain clusters with impact scores, evidence links, and suggested actions — machine-readable for agents, human-readable for founders.\n\n## Quick Start\n\n**Install:**\n\n```bash\npip install feedback-synthesis-mcp\n```\n\n**Set your wallet key** (any EVM wallet with USDC on Base mainnet):\n\n```bash\nexport EVM_PRIVATE_KEY=your_private_key_here\n```\n\n**Add to Claude Desktop** — edit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"feedback-synthesis-mcp\": {\n      \"command\": \"feedback-synthesis-mcp\",\n      \"env\": {\n        \"EVM_PRIVATE_KEY\": \"your_private_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Add to Cursor** — edit `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"feedback-synthesis-mcp\": {\n      \"command\": \"feedback-synthesis-mcp\",\n      \"env\": {\n        \"EVM_PRIVATE_KEY\": \"your_private_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart your client. You now have four customer intelligence tools available.\n\n---\n\n## Tools\n\n| Tool | What it does | Price |\n|------|-------------|-------|\n| `synthesize_feedback` | Multi-source synthesis → ranked pain clusters with evidence | $0.05/call |\n| `get_pain_points` | Quick single-source pain point extraction | $0.02/call |\n| `search_feedback` | Full-text search across cached feedback items | $0.01/call |\n| `get_sentiment_trends` | Time-series sentiment across sources | $0.03/call |\n\n**Supported sources**: GitHub Issues, Hacker News, Apple App Store Reviews\n\n---\n\n## Examples\n\n### Synthesize feedback from multiple sources\n\n```\nsynthesize_feedback(\n  sources=[\n    {\"type\": \"github_issues\", \"target\": \"owner/my-repo\", \"labels\": [\"bug\", \"feature-request\"]},\n    {\"type\": \"hackernews\", \"target\": \"Show HN: MyProduct\"}\n  ],\n  since=\"2026-01-01T00:00:00Z\"\n)\n```\n\nReturns:\n```json\n{\n  \"job_id\": \"syn_abc123\",\n  \"status\": \"completed\",\n  \"summary\": \"Analyzed 347 feedback items from 2 sources. Found 6 pain clusters.\",\n  \"pain_clusters\": [\n    {\n      \"rank\": 1,\n      \"title\": \"Authentication flow breaks on mobile Safari\",\n      \"severity\": \"critical\",\n      \"frequency\": 23,\n      \"impact_score\": 0.92,\n      \"description\": \"Users report inability to complete OAuth login on iOS Safari. Affects onboarding conversion.\",\n      \"evidence\": [\n        {\n          \"source\": \"github\",\n          \"url\": \"https://github.com/owner/my-repo/issues/142\",\n          \"snippet\": \"Login fails silently on Safari 17.2+\"\n        }\n      ],\n      \"suggested_actions\": [\n        \"Fix Safari WebAuthn polyfill (see issue #142)\",\n        \"Add fallback auth flow for mobile browsers\"\n      ]\n    }\n  ]\n}\n```\n\n### Quick pain points from GitHub Issues\n\n```\nget_pain_points(\n  source={\"type\": \"github_issues\", \"target\": \"owner/my-repo\", \"labels\": [\"bug\"]},\n  top_n=5\n)\n```\n\n### Search for specific topics\n\n```\nsearch_feedback(query=\"pricing too expensive\", sources=[\"github_issues\", \"hackernews\"])\n```\n\n### Track sentiment over time\n\n```\nget_sentiment_trends(\n  sources=[{\"type\": \"appstore\", \"target\": \"com.example.myapp\"}],\n  since=\"2025-10-01T00:00:00Z\",\n  granularity=\"weekly\"\n)\n```\n\n---\n\n## Payment\n\nThis MCP uses [x402 micropayments](https://x402.org) on Base mainnet (USDC). You need:\n\n1. An EVM wallet with USDC on Base mainnet\n2. The wallet's private key set as `EVM_PRIVATE_KEY`\n\nEach call costs $0.01–$0.05 USDC. Payments are made automatically — no subscriptions, no API keys.\n\n**No payment configured?** The server returns a helpful error with setup instructions.\n\n---\n\n## Architecture\n\nThis package is a thin MCP client. All processing happens on the hosted backend:\n\n```\nYour Agent / Claude Desktop\n        │\n        ▼\nfeedback-synthesis-mcp (this package)\n  - MCP tool definitions\n  - x402 payment signing\n  - Zero business logic\n        │ HTTPS + x402\n        ▼\nHosted Backend (Railway)\n  - Multi-source data collection\n  - 3-stage LLM pipeline (Haiku × N + Sonnet × 1)\n  - SQLite caching + FTS search\n  - x402 payment verification\n```\n\nServer code is private (moat). Thin client is open source.\n\n\n## Direct MCP over HTTP (Streamable HTTP Transport)\n\nSkip the PyPI package for programmatic/agent access using the hosted MCP endpoint directly:\n\n**MCP Server URL**: `https://feedback-synthesis-mcp-production.up.railway.app/mcp/`\n\nFor MCP clients that support Streamable HTTP transport (Claude Desktop via HTTP, custom agents):\n\n```json\n{\n  \"mcpServers\": {\n    \"feedback-synthesis-mcp\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://feedback-synthesis-mcp-production.up.railway.app/mcp/\"\n    }\n  }\n}\n```\n\nx402 payment is handled automatically by the client SDK. Set `EVM_PRIVATE_KEY` in your environment.\n\n---\n\n---\n\n## License\n\nMIT\n\n",
  "bytes": 5262,
  "sha": "9c1d23d61a45b485cdb6e9c1ea189a762e9b31cbf638ee607a86636ad4f448eb",
  "repo_slug": "sapph1re/feedback-synthesis-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sapph1re_feedback_synthesis_mc_cf8d4aec/readme"
}