# AoTwin

> AoTwin is a freemium MCP server for productivity. MCP server to file, find and update AoTwin tickets from your AI assistant. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $32 a month
- **Platforms:** API, Web
- **Website:** https://aotwin.io/mcp
- **MCP Registry name:** io.aotwin/mcp
- **Categories:** productivity, developer tools
- **Listing updated:** 2026-11-15

## About

The key rule is that filing never starts AoTwin and assigning does. Creating, editing, commenting and closing tickets leave the AI worker idle. Only assigning a ticket to AoTwin begins the work, and that spends credits.

Sign-in is a one-time browser login, with no key to copy, and the assistant then acts as you in your workspace. You can ask for read-only access when you authorise, and then the connection exposes just the read tools. Duplicate checks help too: if someone already filed something similar, you get that ticket back.

The tool set is small: six read tools (whoami, list_requests, get_request, inbox, list_projects, list_people) and seven that change things (create_request, update_request, comment, assign, set_status, reopen, close_request). The site shows set-up for Claude, Claude Code, Cursor, VS Code, Codex and Zed.

## Features

- **Plain-language ticket filing:** The assistant fills in title, details and project from a short request.
- **Inbox of what needs you:** Lists questions from AoTwin and work ready for your review.
- **Read-only mode:** Authorise with read scope only and the connection gets just the read tools.
- **Duplicate awareness:** A similar existing ticket is returned instead of a new one being filed.
- **Explicit hand-off:** Assigning a ticket to AoTwin is the only action that starts work and uses credits.

## Good for

- Turn meeting notes into tickets after reviewing the list
- Ask what is waiting on you in AoTwin
- Check what is in review in a project and who has it
- Summarise what AoTwin changed on a ticket
- Close or reopen tickets without leaving the chat

## Install

### Claude Code (Terminal)

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

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

```sh
https://app.aotwin.io/mcp
```

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

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

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

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

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

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

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

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

## Tools

- `whoami`: Says which person and workspace the connection acts as.
- `list_requests`: Finds tickets by text, project, assignee or status.
- `get_request`: Reads one ticket with what AoTwin changed and the activity so far.
- `inbox`: Lists questions from AoTwin and work ready to review.
- `list_projects`: Lists the workspace's projects and their keys.
- `list_people`: Lists the people in the workspace.
- `create_request`: Files a ticket without starting AoTwin.
- `update_request`: Edits a ticket's title, description or page.
- `comment`: Adds a comment as you.
- `assign`: Assigns a ticket; assigning to AoTwin starts the work.
- `set_status`: Moves a ticket to another status.
- `reopen`: Reopens a done or canceled ticket.
- `close_request`: Cancels a ticket and stops AoTwin if working on it.

## FAQ

### Is there an API key to copy?

No. You sign in to AoTwin when the assistant asks, and it acts as you in your workspace.

### Which plans include the MCP server?

Every plan, including Free.

### Will filing a ticket start AoTwin?

No. Only assigning a ticket to AoTwin starts it, and that uses credits.

### Which assistants are covered?

The site shows steps for Claude, Claude Code, Cursor, VS Code, Codex and Zed, plus mcp-remote for clients that only run local commands.

### Is AoTwin free?

AoTwin has a free plan, with paid plans for more usage or features. Paid plans start at $32 a month.

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

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

### What are the best alternatives to AoTwin?

The closest alternatives to AoTwin 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.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.

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