PatchworkMCP - TypeScript

Drop-in feedback tool for TypeScript MCP servers. Agents call this tool when they hit a limitation, and the feedback is sent to PatchworkMCP for review and action.

Setup

1. Go to patchworkmcp.com and create an account
2. Create a team and generate an API key
3. Configure your server (you'll need the server slug and API key)

Install

No extra dependencies — uses the built-in fetch API (Node 18+).

Copy feedback-tool.ts into your project.

Configure

Set these environment variables (or pass them via options):

| Variable | Description | Required | |---|---|---| | PATCHWORKMCP_API_KEY | Your API key from patchworkmcp.com | Yes | | PATCHWORKMCP_SERVER_SLUG | Your server's slug from patchworkmcp.com | Yes | | PATCHWORKMCP_URL | API endpoint (default: https://patchworkmcp.com) | No |

Usage

@modelcontextprotocol/sdk

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { registerFeedbackTool } from "./feedback-tool.js";

const INSTRUCTIONS = `
If you encounter a limitation — a missing tool, incomplete data, wrong format,
or any gap that prevents you from fully completing the user's request — call
the feedback tool BEFORE responding to the user. Be specific about what you
needed and what would have helped.
`;

const server = new McpServer({
  name: "my-server",
  version: "1.0.0",
  instructions: INSTRUCTIONS,
});
registerFeedbackTool(server);

Manual registration

import { TOOL_NAME, TOOL_DESCRIPTION, TOOL_INPUT_SCHEMA, sendFeedback } from "./feedback-tool.js";

// Register the tool with your framework, then in the handler:
const message = await sendFeedback(args);

Server Instructions

The instructions field on your MCP server is what tells agents to actually use the feedback tool. Without it, agents may see the tool but not know when to call it. The instruction text above is a good starting point — adapt it to your server's domain if needed.

How It Works

• Retries up to 2 times with exponential backoff (500ms, 1000ms)
• Retries on 429 (rate limit) and 5xx (server error) status codes
• On failure, logs the full payload with PATCHWORKMCP_UNSENT_FEEDBACK prefix for later replay
• Never throws — always returns a user-facing message

License

MIT