# Viglet Shio

> Viglet Shio is an open-source MCP server for developer tools. Let Claude Code or any MCP client build, edit and publish pages in a Shio CMS. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://shio.viglet.org/claude-code/
- **Repository:** https://github.com/openviglet/shio/tree/HEAD/cli
- **MCP Registry name:** io.github.openviglet/shio
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Viglet Shio is an open-source CMS designed with an agent interface first, and this bridge connects it to MCP clients. You point it at a running Shio instance with a URL, username and password, and the agent works through the same surface the CMS exposes to its own tooling.

A session normally opens with three steps: read the instance manifest to see what it can do, read the context for the content model, sitemap and available operations, then submit a batch of changes. Batches can be run as a dry run first, and real changes land as drafts to review. Writes use a dedicated agent token scope that is deliberately narrower than a full write key.

The README lists 13 tools plus manifest, blueprint, context and schema resources. A Claude Code plugin adds skills and slash commands such as /shio-start and /shio-check.

## Features

- **Manifest first:** The instance reports its capabilities and limits before the agent writes anything.
- **Dry-run batches:** Changes can be planned without applying, then land as drafts.
- **Content model as code:** Post types and widgets can be pulled and pushed as code.
- **Blueprints:** Reusable page blueprints can be planned and applied.
- **Verification:** A verify tool checks work and separates errors, warnings and unchecked items.
- **Claude Code plugin:** Optional skills and slash commands sit on top of the bare bridge.

## Good for

- Have an agent scaffold a site from a blueprint
- Draft and publish page changes through reviewable batches
- Keep the content model in version control
- Check a site for lint problems before handing it over

## Install

### Claude Code (Terminal)

```sh
claude mcp add shio --env SHIO_USER='<SHIO_USER>' --env SHIO_PASSWORD='<SHIO_PASSWORD>' -- npx -y @viglet/shio
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "shio": {
      "command": "npx",
      "args": [
        "-y",
        "@viglet/shio"
      ],
      "env": {
        "SHIO_USER": "<SHIO_USER>",
        "SHIO_PASSWORD": "<SHIO_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shio": {
      "command": "npx",
      "args": [
        "-y",
        "@viglet/shio"
      ],
      "env": {
        "SHIO_USER": "<SHIO_USER>",
        "SHIO_PASSWORD": "<SHIO_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "shio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@viglet/shio"
      ],
      "env": {
        "SHIO_USER": "<SHIO_USER>",
        "SHIO_PASSWORD": "<SHIO_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shio": {
      "command": "npx",
      "args": [
        "-y",
        "@viglet/shio"
      ],
      "env": {
        "SHIO_USER": "<SHIO_USER>",
        "SHIO_PASSWORD": "<SHIO_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shio": {
      "command": "npx",
      "args": [
        "-y",
        "@viglet/shio"
      ],
      "env": {
        "SHIO_USER": "<SHIO_USER>",
        "SHIO_PASSWORD": "<SHIO_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `shio_context`: Read the content model, sitemap and operations
- `shio_find`: Find content
- `shio_read`: Read content
- `shio_write`: Write changes as a batch
- `shio_apply`: Apply changes
- `shio_publish`: Publish drafts
- `shio_assets`: Work with assets
- `shio_blueprint`: Plan and apply blueprints
- `shio_changes`: List changes
- `shio_verify`: Check work before handoff
- `shio_digest`: Produce a digest of the instance
- `shio_remember`: Store a note
- `shio_forget`: Remove a stored note

## FAQ

### What do I need to connect?

A running Shio instance plus SHIO_USER and SHIO_PASSWORD; SHIO_URL defaults to http://localhost:2710.

### Does it need the plugin?

No. The bare stdio bridge works with any MCP client, but without the skills and commands.

### Do agent writes go live immediately?

Real batches land as drafts to review, and a dry run is available first.

### Which Node version is needed?

The CLI requires Node 26 or later.

### Is Viglet Shio free?

Yes. Viglet Shio is open source, so you can use and self-host it for free.

### How do I add Viglet Shio to Claude Code?

Run this command in your terminal: claude mcp add shio --env SHIO_USER='<SHIO_USER>' --env SHIO_PASSWORD='<SHIO_PASSWORD>' -- npx -y @viglet/shio

### What are the best alternatives to Viglet Shio?

The closest alternatives to Viglet Shio 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/viglet-shio
