Connect AnyCap through MCP

AnyCap CLI v0.5.0 includes a local stdio MCP server with 23 typed tools. It runs inside the existing CLI binary and shares the same authentication, HTTP client, model discovery, and local media handling. It has been verified with MCP protocol version 2025-06-18.

Verify support

anycap mcp --help

If the command is missing, run anycap update.

Configure a host

Claude Code

Store the machine-specific absolute root in Claude’s local project scope:

claude mcp add --scope local anycap -- anycap mcp --allow-root "$PWD"

Codex

The Codex CLI command installs a global server definition. Omit a fixed root and let each project session advertise its root or use the server working directory fallback:

codex mcp add anycap -- anycap mcp

Generic stdio

{
  "mcpServers": {
    "anycap": {
      "type": "stdio",
      "command": "anycap",
      "args": ["mcp", "--allow-root", "/absolute/path/to/media"]
    }
  }
}

Do not commit personal absolute paths

Project-shared MCP configuration should not contain an expanded "$PWD". It is machine-specific and can disclose a username or local directory. Use host-advertised roots, a portable working-directory root, or a local-scope configuration.

Authenticate inside MCP

MCP startup never opens a browser. Existing CLI login is loaded automatically and credentials are refreshed on every tool call.

1. Call anycap_auth_status.
2. If unauthenticated, call anycap_login and show its verification URL and user code.
3. After the human completes login, call anycap_login_poll with the returned session ID.
4. Call anycap_status to verify the server and account.

Authorize local files

Effective local file access is the union of:

• repeatable --allow-root flags
• the platform path list in ANYCAP_MCP_FILE_ROOTS
• roots advertised by the MCP client
• the process working directory when no other roots are configured

Canonical checks reject path traversal, sibling-prefix confusion, and symlink escape. Keep roots as narrow as possible. HTTP(S) URLs and existing AnyCap upload references do not require local access.

Explore the tools

See the MCP tool reference for all 23 tools and their current read/write boundaries.