Jot for Windsurf

Let Windsurf fix what your reviewers report.

Log in once, add the server, and ask Windsurf what is open in Jot: it reads each report with its screenshot, selector and replay summary, fixes the code, and replies on the reviewer's pin.

Connect it

Cursor, Codex, Windsurf, any agent
npx @usejot/cli login
npx @usejot/cli init

login opens your browser to pick a workspace. init connects the repo. No token to paste.

The MCP server, by handany MCP client
{
  "mcpServers": {
    "jot": {
      "command": "npx",
      "args": [
        "-y",
        "@usejot/mcp"
      ],
      "env": {
        "JOT_API_TOKEN": "…"
      }
    }
  }
}

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Step by step in the docs · Set up Jot with an AI agent

What the agent reads

The whole repro, not a guess.

  • The reviewer's sentence and labels, pinned to the element
  • A screenshot of the page as they saw it
  • The URL and the element's CSS selector
  • Browser, operating system and screen size
  • On Record: a replay of the page, with console and network on one timeline
A reviewer's pin on a checkout page, with the agent's reply in the thread saying what it changed.A reviewer's pin on a checkout page, with the agent's reply in the thread saying what it changed.

Made for Windsurf

How it works in Windsurf

  • Add the jot server to ~/.codeium/windsurf/mcp_config.json.
  • jot init also writes a Jot section into AGENTS.md describing how to work the queue.
  • Then ask "what's open in Jot?" or "fix Jot <id>".
fetch_feedback

Start here: to find open work, or to see what is left after a fix.

get_comment

Before touching code for a comment: it is the full repro.

update_status

IN_PROGRESS when you start; RESOLVED once the fix is in and tested, then reply.

post_reply

After every fix (what changed, how to check it), or to ask the reporter a question.

create_batch_note

One change fixed several comments: one note for all of them, not a reply each.

list_projects

Only to see which workspace and projects this token reaches.

Questions

Can Windsurf approve its own fixes?

Agents reply and resolve; who approves is your workspace's choice (by default, the person who reported it).

Which plan do I need?

MCP agents come with every plan, Free included. Reviewers stay free on every plan.

Do I paste a token into Windsurf?

Not if you use the CLI: jot login saves the token in a profile on your machine. To configure by hand, set JOT_API_TOKEN to an agent token from Settings → Agents.

Also for: Claude Code · Cursor · Codex. Send Jots to: GitHub · Linear · Jira · Trello · Microsoft Teams

Your first Jot is a minute away.

Start free. Reviewers are always free, on every plan.