Skip to main content

Documentation Index

Fetch the complete documentation index at: https://recipe.uselettuce.dev/llms.txt

Use this file to discover all available pages before exploring further.

The lettuce cloud MCP endpoint is https://uselettuce.dev/mcp, authenticated with a cwz_… API key. Any MCP-capable agent can connect to it. If you don’t have an API key yet, grab one from uselettuce.dev/keys (see Quickstart, step 2 for screenshots).
Replace cwz_<your-key> in every snippet below with the value you copied from the API keys page. The configs differ mostly in where the file lives.

​
Claude Code

The claude CLI registers the server for you — no file editing.
1

Run

claude mcp add --transport http lettuce https://uselettuce.dev/mcp \
  --header "Authorization: Bearer cwz_<your-key>"
2

Confirm

claude mcp list
lettuce should appear with status connected.

​
Cursor

1

Open Cursor settings

Cmd/Ctrl + , → search MCP → Edit in mcp.json. Or edit .cursor/mcp.json in your project (project-scoped) or ~/.cursor/mcp.json (global).
2

Add the server

{
  "mcpServers": {
    "lettuce": {
      "url": "https://uselettuce.dev/mcp",
      "headers": { "Authorization": "Bearer cwz_<your-key>" }
    }
  }
}
3

Reload

Open the Cursor command palette → Reload Window, or restart Cursor. The new tools appear in the Composer model picker.

​
VS Code (GitHub Copilot)

Copilot’s agent mode reads .vscode/mcp.json. Note the top-level key is servers, not mcpServers.
1

Create the file

In your project, create .vscode/mcp.json.
2

Add the server

{
  "servers": {
    "lettuce": {
      "type": "http",
      "url": "https://uselettuce.dev/mcp",
      "headers": { "Authorization": "Bearer cwz_<your-key>" }
    }
  }
}
3

Switch Copilot to agent mode

Open Chat → mode dropdown → Agent. The lettuce tools appear in the tools picker.

​
Windsurf

1

Open the config

Settings → Cascade → MCP, or edit ~/.codeium/windsurf/mcp_config.json directly.
2

Add the server

{
  "mcpServers": {
    "lettuce": {
      "serverUrl": "https://uselettuce.dev/mcp",
      "headers": { "Authorization": "Bearer cwz_<your-key>" }
    }
  }
}
3

Restart Cascade

Click Refresh in the MCP settings panel, or restart Windsurf.

​
Cline

1

Open MCP settings

In the Cline side panel, click the MCP icon → Configure.
2

Add a remote server

Choose Remote (HTTP). URL: https://uselettuce.dev/mcp. Add a header: name Authorization, value Bearer cwz_<your-key>.
3

Save

Cline reconnects automatically; the lettuce tools appear in the tools list.

​
OpenCode

OpenCode reads mcp.json from the project or user config directory. 
{
  "mcpServers": {
    "lettuce": {
      "url": "https://uselettuce.dev/mcp",
      "headers": { "Authorization": "Bearer cwz_<your-key>" }
    }
  }
}
Restart the agent after saving.

​
Codex CLI / other stdio-only clients

Some MCP clients only speak stdio. Bridge them to the HTTP endpoint with mcp-remote: 
{
  "mcpServers": {
    "lettuce": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://uselettuce.dev/mcp",
        "--header", "Authorization: Bearer cwz_<your-key>"
      ]
    }
  }
}

​
Verify

Ask the agent a question about your codebase — “where is the auth middleware?” — and confirm it calls a lettuce tool (Claude Code shows this in the tool-use box; Cursor shows it in the Composer log).

​
Next: nudge the agent to use it

Installing the MCP gives the agent the tools. It still needs a line in its system prompt telling it when to use them. See Agent instructions for the snippet and where to paste it for each agent (CLAUDE.md, .cursor/rules, Copilot instructions, Windsurf rules, Cline custom instructions).