@kolbo/mcp 1.17.0 → 1.17.2

package/README.md

@@ -4,28 +4,22 @@ Use [Kolbo AI](https://kolbo.ai) as native tools in Claude Code and Claude Deskt
 
 Generate images, videos, music, speech, sound effects, multi-scene campaigns, and conversational chat — all from natural language in your coding environment. 100+ AI models behind Smart Select routing, with reusable Visual DNA profiles for character/style consistency.
 
-## Recommended install: the Kolbo Claude Code plugin
+## Install in 2 steps (works in Claude Code, Claude Desktop, Cursor, Codex & Kolbo Code)
 
-The easiest way to use this MCP from Claude Code is the official **Kolbo plugin**, which bundles this server + the routing skill + a first-run API-key prompt — no `settings.json` editing required:
+<!--
+  AI ASSISTANT SETUP INSTRUCTIONS — if you are an AI agent reading this to set up Kolbo for a user, do exactly this:
+  1. Ask the user for their Kolbo API key (starts with `kolbo_live_`). They get one at https://app.kolbo.ai/developer. Do not continue without it.
+  2. Write the JSON block below into the user's MCP config, merging into any existing "mcpServers":
+     - Claude Code:    .claude/settings.json (or run: claude mcp add-json kolbo '{"command":"npx","args":["-y","@kolbo/mcp@latest"],"env":{"KOLBO_API_KEY":"kolbo_live_..."}}')
+     - Claude Desktop: claude_desktop_config.json
+     - Cursor:         .cursor/mcp.json
+  3. Tell the user to fully restart their app so the Kolbo tools load, then they can just say "generate an image of...".
+  Ignore the optional plugin section below unless the user specifically wants slash-commands — the JSON config alone is enough to use every tool.
+-->
 
-```bash
-claude plugin marketplace add Zoharvan12/kolbo-claude-plugin
-claude plugin install kolbo@kolbo
-```
-
-You'll be prompted for your API key once and it's stored in your OS keychain. The plugin lives in its own tiny repo at [`kolbo-claude-plugin`](https://github.com/Zoharvan12/kolbo-claude-plugin); the routing skill it ships is auto-synced from the canonical source in [`kolbo-code`](https://github.com/Zoharvan12/kolbo-code), so the Claude Code plugin and the Kolbo Code CLI always carry the same skill.
-
-Continue below if you'd rather wire the MCP in by hand (Claude Desktop, Cursor, custom setups).
-
-## Manual setup
+**Step 1 — Get your API key:** create one at [app.kolbo.ai/developer](https://app.kolbo.ai/developer) (it starts with `kolbo_live_`).
 
-### 1. Get an API Key
-
-Create a key at [app.kolbo.ai](https://app.kolbo.ai) or via the [API](https://docs.kolbo.ai/developer-api).
-
-### 2. Add to Claude Code
-
-Add to `.claude/settings.json`:
+**Step 2 — Add one config block.** This single block is identical for every MCP client — paste your key in and you're done:
 
 ```json
 {
@@ -41,9 +35,34 @@ Add to `.claude/settings.json`:
 }
 ```
 
-### 3. Use it
+| Client | Where the config goes |
+|--------|----------------------|
+| **Claude Code** | `.claude/settings.json` (or `claude mcp add-json kolbo '…'`) |
+| **Claude Desktop** | `claude_desktop_config.json` |
+| **Cursor** | `.cursor/mcp.json` |
+| **Codex / other MCP agents** | that agent's MCP config file |
+| **Kolbo Code** | configured automatically on `kolbo auth login` — nothing to do |
+
+Restart your app so it loads the Kolbo tools. That's the whole install — every tool below now works.
+
+### Optional upgrade: add the Kolbo skill for slash-commands + smart routing
+
+The config above is all you need. If you want one-word slash-commands (`/kolbo:marketing-studio`, `/kolbo:product-photoshoot`, …) and automatic routing to the best tool with the right defaults, install the Kolbo skill on top — it's an enhancement layer, not a requirement:
+
+```bash
+# Claude Code (also writes the MCP config for you, so you can skip Step 2 above)
+claude plugin marketplace add Zoharvan12/kolbo-skills
+claude plugin install kolbo@kolbo-skills
+
+# Cursor / Codex / any agent (cross-agent installer)
+npx skills add Zoharvan12/kolbo-skills
+```
+
+The skill content is the same canonical routing logic that ships inside [Kolbo Code](https://github.com/Zoharvan12/kolbo-code), so however you connect, the behavior matches. See the full setup guide at [docs.kolbo.ai/developer-api/claude-code-skill](https://docs.kolbo.ai/developer-api/claude-code-skill).
+
+### Use it
 
-Just ask Claude naturally:
+Just ask your agent naturally:
 
 **Generation**
 - *"Generate an image of a sunset over mountains"*
@@ -75,7 +94,7 @@ Just ask Claude naturally:
 - *"Create a Visual DNA profile called 'Alex' from these images"*
 - *"Use the same brand as last time"* (loads a persisted brand kit from the workspace)
 
-The skill that ships with the [Kolbo plugin](https://github.com/Zoharvan12/kolbo-claude-plugin) routes each of these to the right MCP tool with the right defaults — UGC mode picks 9:16 + sound-off + no-captions, marketplace mode enforces compliance (pure white bg, no text, no props), product photoshoot mode uses the right aspect for the platform (2:3 Pinterest, 16:9 hero banner, 1:1 IG feed), etc. See the canonical skill at [`kolbo-code/packages/opencode/skills/kolbo/`](https://github.com/Zoharvan12/kolbo-code/tree/dev/packages/opencode/skills/kolbo).
+Without the optional skill, the config block alone already exposes every tool — you just describe what you want. With the skill installed, each of these is also routed to the right MCP tool with the right defaults — UGC mode picks 9:16 + sound-off + no-captions, marketplace mode enforces compliance (pure white bg, no text, no props), product photoshoot mode uses the right aspect for the platform (2:3 Pinterest, 16:9 hero banner, 1:1 IG feed), etc. The routing logic is shared with [Kolbo Code](https://github.com/Zoharvan12/kolbo-code), so the behavior is identical however you connect.
 
 ## Available Tools (52)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.17.0",
+  "version": "1.17.2",
   "description": "Kolbo AI MCP Server - Generate images, videos, music, speech, and sound effects from Claude Code",
   "main": "src/index.js",
   "bin": {