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

# Set Up with Cursor

> Connect Smithers to Cursor: no plugin exists, so we recommend the MCP server, with skill files for the headless cursor-agent.

Cursor has no Smithers plugin, so we recommend the MCP server: it gives
Cursor's Agent structured tools to list, run, watch, and approve workflows.

## Install (recommended)

Run in your project:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
bunx smithers-orchestrator init
bunx smithers-orchestrator mcp add --agent cursor
```

Reopen Cursor and the Smithers tools appear in the Agent. If you also use the
headless `cursor-agent` CLI, add the skill files too:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
bunx smithers-orchestrator skills add
```

## Check it worked

Ask Cursor's Agent:

> "What Smithers workflows are available here?"

It should list them via the Smithers tools. From there, ask for outcomes
([What You Can Do](/guide/what-you-can-do)) and Cursor drives the runs.

<Note>
  The agent-facing details (mcp.json shape, rules, headless mode) live in the
  Technical API at [Cursor](/agents/cursor). You don't need them; Cursor does.
</Note>