# TweakThis

> TweakThis is a freemium MCP server for developer tools. Hands website feedback from clients to your coding agent to fix and report back. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, Chrome extension, API
- **Website:** https://tweakthis.io/docs/mcp
- **MCP Registry name:** io.tweakthis/mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Feedback is captured in the browser with an extension: a note, the page and element it points at, and screenshots. The MCP server passes each item to Claude Code, Codex or another agent, which fixes it in your repository and submits a resolution for you to accept or reopen in the dashboard. An agent can also wait for new feedback while people review.

To avoid two agents working on one item, claim_feedback locks it for 15 minutes, renewable. Connecting with OAuth lets you pick the workspaces, projects and permissions, and the server can then create the project from the git remote and dev port, manage environments and URL rules, and invite a client by email or reporter link. Personal access tokens work for feedback only.

Some things stay with people: leaving feedback, approving access, accepting fixes, and choosing and paying for a plan. Reads of feedback and attachments count toward a monthly allowance that varies by plan.

## Features

- **Feedback with context:** Gives the agent the note, expected and actual result, page and element, and screenshots.
- **Claim and release:** Locks an item for 15 minutes so only one agent works on it.
- **Wait for changes:** Lets an agent work unattended until new feedback or reopens arrive.
- **Project setup by agent:** With OAuth and the right permissions, creates projects and URL rules from the repository.
- **Client invitations:** Emails an invitation or makes a reporter link for a client.
- **Resolution review:** Submits what changed and how it was checked, for a person to accept or reopen.

## Good for

- Let a client leave notes on a staging site and have an agent fix them
- Run an agent unattended while reviewers add feedback
- Set up a feedback project for the repository you are in
- Invite a client reporter from the terminal
- Review screenshots of a reported bug inside the agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://tweakthis.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tweakthis.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://tweakthis.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://tweakthis.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://tweakthis.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://tweakthis.io/mcp"
    }
  }
}
```

## Tools

- `list_projects`: Lists granted projects with each one's repository hint.
- `list_feedback`: Lists items in a project or review session, most recently updated first.
- `list_changes`: Shows new items, answers, reopens and assignments since the last call.
- `wait_for_changes`: Waits until something changes.
- `get_feedback`: Returns one item with note, expected and actual result, and page and element context.
- `get_attachment`: Returns a screenshot or element crop as an image.
- `claim_feedback`: Claims an item for 15 minutes, renewable.
- `release_feedback`: Gives an item back when the agent stops.
- `add_comment`: Adds progress or a question that sets the item to needs input.
- `submit_resolution`: Reports what changed and how it was checked, ready for review.
- `list_workspaces`: Lists workspaces, their plan and active projects.
- `get_project`: Shows a project's URLs, repository, environments and rules.
- `create_project`: Creates a project for the repository with its first URL rule.
- `update_project`: Updates name, primary URL, repository hint, subdirectory and capture exclusions.
- `set_project_archived`: Archives or unarchives a project.
- `manage_environments`: Adds, renames or deletes an environment.
- `manage_url_rules`: Adds, updates, toggles or deletes URL rules and loopback aliases.

## FAQ

### How do I connect?

Add https://tweakthis.io/mcp with OAuth (recommended) or send a personal access token as a bearer header.

### Can an agent create projects with a token?

No. A token works through feedback only; project setup and invitations need OAuth with the Manage projects and Invite people permissions.

### What does it cost?

Free for 1 project and 20 feedback items a month; Pro is €15 a month and Team €49 a month, excluding VAT.

### Can an agent buy a plan?

No. Choosing and paying for a plan is left to a person; an agent never starts a checkout.

### Is TweakThis free?

TweakThis has a free plan, with paid plans for more usage or features.

### How do I add TweakThis to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://tweakthis.io/mcp

### What are the best alternatives to TweakThis?

The closest alternatives to TweakThis are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/tweakthis
