# Canvas MCP

> Canvas MCP is a freemium MCP server for productivity. Hire and configure AI staff, run actions and publish knowledge bases on TeamAgent Canvas. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, Web
- **Website:** https://agent.avatargaia.top
- **Repository:** https://github.com/avatargaia/canvas-mcp
- **MCP Registry name:** io.github.AvatarGaia/canvas-mcp
- **Categories:** productivity, knowledge and memory
- **Listing updated:** 2026-11-16

## About

TeamAgent is a platform where each team member gets an AI agent, and this package is a stdio wrapper around its hosted MCP servers, for clients that only support stdio such as Claude Desktop, Cursor and Cline. The README is in Chinese. The wrapper is stateless and passes requests through unchanged, and it returns upstream HTTP errors (401, 402, 429) as JSON-RPC errors so the real cause is visible.

The Canvas endpoint has more than 90 tools for creating roles, changing configuration, running actions, viewing data and publishing. Anonymous use is allowed with a free sandbox of 18 tools, and a dk_ developer key or ta_ platform token unlocks the rest. A second endpoint, AICare, has 7 paid-per-use tools for AI health detection across 13 categories such as tongue, face and nails, and always needs a key.

Version 0.4.0 added knowledge bases for digital staff. list_kbs, read_kb, publish_kb, set_staff_kbs and hire_staff let you publish a Markdown wiki and attach it to a role, so the role answers from the base first and says so when it has no answer. The README warns that publishing makes the content public to anonymous visitors, and sets limits of 200 files, 64 KB each and 2 MB total.

## Features

- **Stdio wrapper:** Lets stdio-only clients reach TeamAgent's Streamable HTTP servers.
- **Anonymous sandbox:** 18 free tools work without a key.
- **Staff knowledge bases:** Publish a Markdown wiki and attach it to an AI role.
- **Self-service keys:** Register through an API call to get a dk_ key and 20 credits.
- **Tool annotations:** Tools carry read-only and destructive hints, with credit costs in descriptions.
- **AICare endpoint:** Seven paid tools for AI health detection.

## Good for

- Hire an AI staff role from a template and give it a knowledge base
- Publish a product wiki that a role answers from
- Try TeamAgent tools anonymously from a local client
- Review which knowledge bases each role uses

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http canvas-mcp https://agent.avatargaia.top/api/mcp/canvas
```

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

```sh
https://agent.avatargaia.top/api/mcp/canvas
```

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

```json
{
  "mcpServers": {
    "canvas-mcp": {
      "url": "https://agent.avatargaia.top/api/mcp/canvas"
    }
  }
}
```

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

```json
{
  "servers": {
    "canvas-mcp": {
      "type": "http",
      "url": "https://agent.avatargaia.top/api/mcp/canvas"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "canvas-mcp": {
      "serverUrl": "https://agent.avatargaia.top/api/mcp/canvas"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "canvas-mcp": {
      "type": "http",
      "url": "https://agent.avatargaia.top/api/mcp/canvas"
    }
  }
}
```

## Tools

- `list_kbs`: List your knowledge bases and which roles use them
- `read_kb`: Read a knowledge base's page list or one page
- `publish_kb`: Publish a wiki as a knowledge base, replacing the previous one
- `set_staff_kbs`: Set which knowledge bases a role uses
- `hire_staff`: Create a role from a template, optionally with knowledge bases

## FAQ

### Do I need an account?

No. External agents can register for a key with one API call, or use the free anonymous sandbox.

### What is limited in a knowledge base?

Up to 200 files, 64 KB per file and 2 MB in total.

### Is published knowledge private?

No. The README warns that publishing is public to anonymous visitors, so avoid private or internal material.

### What does the AICare endpoint need?

A key; it is billed per use.

### Is Canvas MCP free?

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

### How do I add Canvas MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http canvas-mcp https://agent.avatargaia.top/api/mcp/canvas

### What are the best alternatives to Canvas MCP?

The closest alternatives to Canvas MCP are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [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.
- [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.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

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