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

# MCP Setup

> Configure @byul/mcp in Cursor, Claude Code, Windsurf, and more

## Environment variable

```bash theme={null}
export BYUL_API_KEY=byul_api_key
```

<Warning>
  Never hardcode API keys. Use environment variables instead.
</Warning>

## Cursor

`~/.cursor/mcp.json` or project `.cursor/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "byul": {
      "command": "npx",
      "args": ["-y", "@byul/mcp"],
      "env": { "BYUL_API_KEY": "byul_api_key" }
    }
  }
}
```

## Claude Code (VS Code extension)

CLI:

```bash theme={null}
claude mcp add -e BYUL_API_KEY=byul_api_key --scope user byul npx -- -y @byul/mcp
```

Settings JSON:

```json theme={null}
{
  "mcpServers": {
    "byul": {
      "command": "npx",
      "args": ["-y", "@byul/mcp"],
      "env": { "BYUL_API_KEY": "byul_api_key" }
    }
  }
}
```

## Claude Desktop

`claude_desktop_config.json`:

```json theme={null}
{
  "mcpServers": {
    "byul": {
      "command": "npx",
      "args": ["-y", "@byul/mcp"],
      "env": { "BYUL_API_KEY": "byul_api_key" }
    }
  }
}
```

## VS Code

Workspace `.vscode/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "byul": {
      "command": "npx",
      "args": ["-y", "@byul/mcp"],
      "env": { "BYUL_API_KEY": "byul_api_key" }
    }
  }
}
```

## Windsurf

`windsurf_mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "mcp-server-byul": {
      "command": "npx",
      "args": ["-y", "@byul/mcp"],
      "env": { "BYUL_API_KEY": "byul_api_key" }
    }
  }
}
```