> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowdeck.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Call FlowDeck's active MCP tools from the CLI

FlowDeck exposes its user-facing tools as an MCP server. `flowdeck mcp` lets you call those tools directly from the command line, which is how agent hosts that cannot hold a long-lived MCP connection (such as Cursor's direct client) invoke FlowDeck's blocking tools through a single foreground command.

## flowdeck mcp call

Call a FlowDeck MCP tool by name and pass its arguments as a JSON object. The tool runs against the same active FlowDeck MCP server the app exposes, and the result is printed to stdout.

```bash theme={null}
# Call a tool with no arguments (defaults to {})
flowdeck mcp call flowdeck_worktree_list

# Pass arguments as a JSON object
flowdeck mcp call flowdeck_update_tasks --json '{"tasks":[{"title":"Ship feature","status":"in_progress"}]}'

# Ask the user a question (blocks until they answer)
flowdeck mcp call flowdeck_ask_user --json '{"questions":[...]}'

# Show usage examples
flowdeck mcp call --examples
```

### Options

| Option          | Short | Description                                                 |
| --------------- | ----- | ----------------------------------------------------------- |
| `<tool-name>`   |       | FlowDeck MCP tool name, for example `flowdeck_update_tasks` |
| `--json <json>` |       | JSON object to pass as the tool arguments (default: `{}`)   |
| `--examples`    | `-e`  | Show usage examples                                         |

### When to use it

* **Blocking tools:** `flowdeck_ask_user` and `flowdeck_plan` block until the user responds. From agent hosts whose direct MCP client has a short deadline, call them through `flowdeck mcp call <tool> --json '<args>'` as a single foreground command so the call can wait for a real human response.
* **Task and worktree tools:** `flowdeck_update_tasks`, `flowdeck_worktree_list`, `flowdeck_worktree_create`, and `flowdeck_worktree_delete` can be invoked the same way when a host does not expose them as direct tools.

<Note>
  `flowdeck mcp call` is the required transport for `flowdeck_ask_user` and `flowdeck_plan` from agent hosts that cannot hold a long-lived MCP connection. Do not attempt a direct MCP call for either tool from such hosts.
</Note>