Adding a new agent runtime

Recipes supports 10 agent runtimes out of the box. Pick your runtime below for the exact install command and config snippet. All paths need your RECIPES_API_KEY environment variable set. See Getting started for key setup.

For a visual overview of all integrations, see the Integrations page.

Native skill drop (no MCP server needed)

These runtimes auto-discover SKILL.md files. Drop the file in once; the agent picks it up automatically on next start.

Hermes

Hermes reads skills from ~/.hermes/skills/. After install, the recipes_search, recipes_install, and recipes_sync MCP tools are available automatically via the Recipes MCP server bundled in the skill.

mkdir -p ~/.hermes/skills/recipes
curl -sL https://recipes.wisechef.ai/skill \
     -o ~/.hermes/skills/recipes/SKILL.md
export RECIPES_API_KEY=rec_xx...

Claude Code

Claude Code reads skills from ~/.claude/skills/:

mkdir -p ~/.claude/skills/recipes
curl -sL https://recipes.wisechef.ai/skill \
     -o ~/.claude/skills/recipes/SKILL.md
export RECIPES_API_KEY=rec_xx...

OpenClaw

OpenClaw mounts the same skill directory layout as Claude Code. Drop the meta-skill in once; every spawned agent inherits it:

mkdir -p ~/.openclaw/skills/recipes
curl -sL https://recipes.wisechef.ai/skill \
     -o ~/.openclaw/skills/recipes/SKILL.md
export RECIPES_API_KEY=rec_xx...

Codex CLI

OpenAI Codex CLI uses the same format:

mkdir -p ~/.codex/skills/recipes
curl -sL https://recipes.wisechef.ai/skill \
     -o ~/.codex/skills/recipes/SKILL.md
export RECIPES_API_KEY=rec_xx...

MCP server integrations

These runtimes use the Model Context Protocol. Install the Recipes MCP server once; your agent gets recipes_search, recipes_install, recipes_sync, and all other Recipes tools.

Install the MCP server:

pip install recipes-mcp   # or: uvx recipes-mcp (no install, runs directly)

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "recipes": {
      "command": "uvx",
      "args": ["recipes-mcp"],
      "env": {
        "RECIPES_API_KEY": "rec_xx..."
      }
    }
  }
}

Restart Claude Desktop. The Recipes tools appear in the tool picker.

Cursor

Open Cursor Settings → MCP → Add Server, or edit .cursor/mcp.json:

{
  "mcpServers": {
    "recipes": {
      "command": "uvx",
      "args": ["recipes-mcp"],
      "env": { "RECIPES_API_KEY": "rec_xx..." }
    }
  }
}

Cline (VS Code extension)

In VS Code, open Cline settings → MCP Servers → Edit JSON:

{
  "mcpServers": {
    "recipes": {
      "command": "uvx",
      "args": ["recipes-mcp"],
      "env": { "RECIPES_API_KEY": "rec_xx..." }
    }
  }
}

Skills installed via the recipes_install tool are written to ~/.claude/skills/ by default; Cline picks them up.

Continue.dev

Edit ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "uvx",
          "args": ["recipes-mcp"],
          "env": { "RECIPES_API_KEY": "rec_xx..." }
        }
      }
    ]
  }
}

Zed

Edit ~/.config/zed/settings.json:

{
  "context_servers": {
    "recipes": {
      "command": {
        "path": "uvx",
        "args": ["recipes-mcp"],
        "env": { "RECIPES_API_KEY": "rec_xx..." }
      }
    }
  }
}

Any agent (REST API)

If your agent can make HTTP requests, you can use the Recipes REST API directly. No MCP server required.

# Search
curl -H "x-api-key: $RECIPES_API_KEY"   "https://recipes.wisechef.ai/api/skills/search?q=seo"

# Install (get signed tarball URL)
curl -H "x-api-key: $RECIPES_API_KEY"   "https://recipes.wisechef.ai/api/skills/install?slug=super-memory&mode=files"

See API reference for full endpoint docs.

Common troubleshooting

"Skills install but agent ignores them" — the agent's skills directory is non-standard. Check the agent's docs and copy the installed files there manually, or set RECIPES_INSTALL_DIR to the correct path.
"recipes_install tool not found" — the MCP server isn't configured or started. Re-check your config file and restart the agent.
"401 Unauthorized" — your RECIPES_API_KEY env var isn't being passed to the MCP server process. Check the env block in your config.
"403 Subscription required" — the skill requires a Cook or Operator subscription. Check pricing or install a free-tier skill first (e.g. super-memory).

Building a custom runtime profile

If your agent isn't listed here, it likely accepts one of the two patterns above: a skill directory drop (if it follows the Claude Code SKILL.md standard) or an MCP server config. If neither works, contact us — we add new native profiles when two operators validate them on different machines.

Adding Recipes to your agent