Back to Directory/Media & Images

ai.kavel/kavel-mcp

Discover Kavel's AI photo/video generators, get tuned prompts, and open the right tool on kavel.ai.

Media & ImagesTypeScriptv0.1.1

Kavel MCP

An MCP server for Kavel — bring Kavel's AI photo & video generators into any MCP client (Claude, Cursor, Cline, …). Ask for an effect, get a model-tuned prompt, and open the right tool to generate it on www.kavel.ai.

No account or API key required to use this server — it helps you pick a tool and craft a prompt, then hands off to Kavel's free-tier generators.

What it does

ToolWhat it returns
list_kavel_toolsBrowse/search Kavel's generators by goal (e.g. "make my dog look royal")
build_kavel_promptA model-tuned prompt recipe for a chosen effect, customized with your details
open_in_kavelThe direct generator URL, pre-set to the right mode
list_kavel_modelsThe image/video models Kavel runs and what each is good at

Featured generators

Install

Run directly with npx:

npx kavel-mcp

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "kavel": {
      "command": "npx",
      "args": ["-y", "kavel-mcp"]
    }
  }
}

Cursor / Cline

Point the client at the command npx -y kavel-mcp (stdio transport).

Skill (Claude Code / Cursor / Codex)

This repo also ships the kavel-image-studio agent skill (skills/kavel-image-studio/) — it helps pick the right Kavel generator, craft a model-tuned prompt, and hand off the generate link.

Install via the open agent-skills CLI:

npx skills add hanshs474/kavel-mcp

Or as a Claude Code plugin marketplace:

/plugin marketplace add hanshs474/kavel-mcp
/plugin install kavel-image-studio

Develop

npm install
npm run build
npm start

Links

License

MIT © Kavel

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y kavel-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "ai-kavel-kavel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kavel-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

kavel-mcpnpm

Compatible MCP Clients

ai.kavel/kavel-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More