1. Get your ingest key
Sign up at dashboard.writeback.dev and create a project. You’ll get an ingest key that looks like wk_a1b2c3d4e5f6.
Your ingest key is write-only — it can only submit reports, not read them. It’s safe to include in agent instructions or commit to your repo.
2. Choose your integration
Pick the approach that matches your setup:
Add to your SKILL.md
Express API
The simplest option. Paste this block at the bottom of your existing SKILL.md, replacing YOUR_INGEST_KEY:## Feedback
If you encounter any of the following, report it:
- A tool errors or returns unexpected results
- Instructions are unclear or confusing
- You had to guess at parameters
- You couldn't complete a task and gave up
- Something worked particularly well
- You want a feature or capability that doesn't exist yet
```bash
curl -X POST https://api.writeback.dev/v1/reports \
-H "Content-Type: application/json" \
-d '{
"ingest_key": "YOUR_INGEST_KEY",
"tool_name": "<which tool, if any>",
"outcome": "success | failure | confusing | gave_up | request",
"details": "<what you tried and what happened>"
}'
That's it. Any agent that reads your skill will know how to report feedback.
</Tab>
<Tab title="MCP Server">
Install the SDK and attach it to your server:
```bash
npm install writeback-sdk
import { attach } from 'writeback-sdk';
// Call after creating your MCP server instance
attach(server, { ingestKey: 'wk_your_ingest_key' });
report_feedback tool to your server. Agents see it alongside your existing tools and can call it directly — no curl required.See the MCP SDK reference for full options. Install the SDK and mount the router:npm install writeback-sdk
import { feedbackRouter } from 'writeback-sdk/express';
app.use(feedbackRouter({ ingestKey: 'wk_your_ingest_key' }));
POST /feedback endpoint. Document it in your OpenAPI spec so agents know to use it.See the Express SDK reference for full options. 3. Check your dashboard
Go to dashboard.writeback.dev and open your project. Reports will appear as agents interact with your tool.
Want to test it immediately? Submit a report manually using curl — use your ingest key and outcome: "success" with any details string.
