ArchitectArchitect

MCP

October 23, 2026|

Experimental. Agent 1.1.55 or newer.

Enable

Add this to config.toml and restart the Agent.

[mcp]
enabled = true
read_only = false

Both values default to false. With enabled false, /mcp responds that MCP is disabled.

read_only true rejects write commands.

The endpoint is the Agent listen address, path /mcp. Default: https://<agent>:8090/mcp.

Send Authorization: Bearer <token>.

Token

One token per user. The user needs agent.mcp. See Multi-User and RBAC.

The secret is not shown again. Store it when generate or rotate returns it.

MCP calls are marked in the audit log.

Tools

server, file, backup, mod, title.

Each call sends command and an optional parameters object. command help lists the commands for that tool.

These file commands are not available: write_file, delete_file, move_file, file_upload, file_zip, file_unzip.

A write that is still running returns pending and an idempotence value. Read it with the server tool, command result.

Was this article helpful?
Back to Architect