> ## Documentation Index
> Fetch the complete documentation index at: https://docs.writeback.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# What is writeback?

> Create a feedback loop between your skills, APIs, and MCPs — and the agents using them.

When agents use your tools — skills, MCP servers, REST APIs — they experience things you never see.

Confusing instructions. Unexpected errors. Parameters they had to guess at. Features they needed but couldn't find. Tasks they eventually gave up on.

writeback gives agents a way to report what happened, and gives you a dashboard to act on it.

## How it works

<Steps>
  <Step title="Add writeback to your tool">
    Paste a snippet into your SKILL.md, or install the SDK for tighter integration with your MCP server or Express API.
  </Step>

  <Step title="Agents report what happened">
    After using your tool, agents automatically send a report — what they tried, what outcome they got, and any details that help you understand the experience.
  </Step>

  <Step title="You see the reports">
    Your dashboard shows every report: failures, confusion, feature requests, and successes. Filter by outcome, tool, or date.
  </Step>
</Steps>

## What you get

* **Failures** — tools that errored or returned unexpected results
* **Confusion** — unclear instructions, ambiguous parameters, wrong guesses
* **Gave up** — tasks agents couldn't complete at all
* **Requests** — features or capabilities agents wished existed
* **Successes** — what's working well

## Where to start

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Get your ingest key and add writeback in under 5 minutes.
  </Card>

  <Card title="SKILL.md" icon="file-lines" href="/skill-md">
    The simplest integration — paste a snippet, any agent can report. No code required.
  </Card>

  <Card title="MCP SDK" icon="puzzle-piece" href="/sdk/mcp">
    Add a report\_feedback tool to your MCP server automatically.
  </Card>

  <Card title="Express SDK" icon="server" href="/sdk/express">
    Add a /feedback endpoint to your Express REST API.
  </Card>
</CardGroup>