# Runtype for Agents

Connect to Runtype so you can help the user build AI products, agents, flows, and evals.

## Install Runtype Skills

One command gives your agent deep knowledge of the Runtype platform — surfaces, flow steps, SDK patterns, CLI commands, and end-to-end recipes:

```
npx skills add runtypelabs/skills
```

Works with Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini, and 25+ more agents via [skills.sh](https://skills.sh). Six skills are included: product building, account management, Persona widget embedding, template packaging, and SDK/CLI usage. A router skill activates the right specialist based on your intent.

## Connect via MCP (recommended)

One command connects Claude Code, Cursor, Windsurf, or any MCP client:

```
claude mcp add --transport http runtype https://api.runtype.com/v1/mcp/protocol
```

The user will be prompted to authenticate in-browser via OAuth.

For Cursor / Windsurf / Claude Desktop, add to `mcp.json`:

```json
{
  "mcpServers": {
    "runtype": {
      "url": "https://api.runtype.com/v1/mcp/protocol",
      "transport": "http"
    }
  }
}
```

## Alternative: the CLI

```
npm install -g @runtypelabs/cli
runtype auth login
runtype auth whoami
```

`runtype auth login` opens a browser for the user to authenticate. Export the key for stdio MCP:

```
export RUNTYPE_API_KEY=$(runtype auth export-key)
```

## Alternative: manual API key

Ask the user to:

1. Visit [use.runtype.com/settings/api-keys](https://use.runtype.com/settings/api-keys)
2. Create a key (starts with `rt_live_`)
3. Paste it into your environment as `RUNTYPE_API_KEY`

## What you can do

Once connected via MCP you have ~40 tools. Start with the `build-product` prompt — it returns the platform catalog, schemas, and instructions tailored for agents. You can also:

- Create and run flows (prompt chains, transform steps, conditionals, loops)
- Build and execute agents with tool use, subagents, and MCP integrations
- Manage records, evals, API keys, and secrets
- Deploy surfaces (chat widgets, APIs) for end users
- Generate complete products from a single description

Other MCP prompts: `generate-flow`, `explain-capabilities`.

Docs: [runtype.com](https://runtype.com)