Back to Mise

`mise mcp`

docs/cli/mcp.md

2026.9.21.8 KB
Original Source
<!-- @generated by usage-cli from usage spec -->

mise mcp

Run the Model Context Protocol server over stdin/stdout

Exposes project tools, tasks, environment, and configuration to an MCP client. Resources use mise://tools, mise://tasks, mise://env, and mise://config. mise://tools?include_inactive=true also includes inactive installations.

The list_commands tool describes commands and their declared effects. run_task executes project tasks with the user's permissions and can change files or invoke external services. install_tool is advertised but currently returns an error. Environment resources contain real values, including secrets.

Resources available:

  • mise://tools - List all tools (use ?include_inactive=true to include inactive tools)
  • mise://tasks - List all tasks with their configurations
  • mise://env - List all environment variables
  • mise://config - Show configuration files and project root

Tools available:

  • list_commands - Every mise command, with its declared effect on the world
  • install_tool - Install a tool with an optional version (not yet implemented)
  • run_task - Execute a mise task with optional arguments

Note: This is primarily intended for integration with AI assistants like Claude, Cursor, or other tools that support the Model Context Protocol. See https://mise.jdx.dev/mcp.html for client configuration and access controls.

Flags

  • -h --help — Print help

Examples

Start from the project directory; an MCP client handles the protocol exchange

mise -C /path/to/project mcp
<!-- generated reference navigation -->