Allow AI to get docs for mise using MCP

[deevus]

I often get Claude Code to create mise tasks based off of things I did in the session with it. I really like the integration of usage but CC needs to be fed the docs first before it can create a script that uses usage.

It would be awesome if the MCP had a mise://usage_docs or similar tool that it hit for an example and/or documentation of how to write a mise task using usage.

Additionally, there could be a command to stub a new task script file.

[jdx]

I like the idea, I'm not sure how to indicate to claude in a way that it would know to check this though

[richardthe3rd]

I wonder if we could create mise skills as parts of a Claude plug-in that could help with task creation.

https://docs.claude.com/en/docs/claude-code/skills

A mise-create-task skill could help guide Claude in creating tasks.

[deevus]

Yeah I love that idea. That would be even better than an MCP.

[richardthe3rd]

Sketching this out a bit to see what it looks like:

1. Claude Code Plugins --> https://anthropic.mintlify.app/en/docs/claude-code/plugins are distributed via Claude Code Plugin Marketplaces --> https://anthropic.mintlify.app/en/docs/claude-code/plugin-marketplaces
2. Both Plugins and Marketplaces are basically JSON in git repos

If we use https://github.com/jdx/mise as the marketplace (which means adding .claude-plugins/marketplace.json to the repo), and then adding the marketplace in Claude Code looks like this:

/plugin marketplace add jdx/mise

Assuming the plugin is also in this repo it means adding ./plugins/mise/ folder (with maybe .claude-plugins/plugin.json - I'm still figuring that out)

The plugin can configure the mcp server, but also define skills, subagents, slash-commands and hooks.

I've played around with a single mise skill (using claude to generate most of it) and brain dump my preferences for how mise should be used into it, and defintely saw better results when (for example) converting a project from using a Makefile to using mise. YMMV.

1. Do this, even though - for now - just for Claude Code?
2. If so, do it in this repo, or somewhere else?

[richardthe3rd]

I've created a bare bones marketplace + plugin on my fork

You can see the changes: main...richardthe3rd:mise:claude-plugin

You can also test it locally:

git clone --depth 1 https://github.com/richardthe3rd/mise.git -b claude-plugin

Then in Claude Code add that the root of that clone as a marketplace

/plugin marketplace add ./mise
/plugin install mise-en-place@mise-en-place

This doesn't have any of the skills etc that would help Claude Code know when and how to use mise - just the mcp server:

[richardthe3rd]

Next iteration:

• Used Claude + https://github.com/anthropics/skills/tree/main/skill-creator skill to create a mise-workflow skill that aims to "Assist developers working in mise-enabled projects with understanding available tools/tasks, running commands, and adding new capabilities." and Claude is told to "Use when the user needs to inspect a project, execute tasks, or add tools/tasks during active development."
• Tried adding a SessionStart hook to detect mise.toml and inject mise related things into the context. This is not working right now - maybe due to SessionStart hooks not working for new conversations anthropics/claude-code#10373 maybe due to me not understanding hooks.

[kinoward]

I've created a skill called mise-guide that takes a simpler approach — it's a portable agent skill that teaches AI agents how to use mise properly, covering tool versions, env vars, and tasks.

It's not a Claude Code plugin or MCP server, but a lightweight alternative that works across multiple coding agents (Claude Code, Codex, Gemini CLI, etc.) today. I've been using it with Claude Code and it handles mise cli well.

Install:

npx skills add https://github.com/kinoward/agent-skills --skill mise-guide

Feel free to reach out if you have any questions or suggestions. Thanks.

[deevus]

It would be good to include a reference for how to integrate usage in mise tasks.

[joeblew999]

Nice - for me, Claude is really bad at using Mise so will try this out.

it would be great if the skills were part of the mise repo itself ?

For example:
https://github.com/emdash-cms/emdash/tree/main/skills