# @avallon-labs/mcp

Avallon MCP (Model Context Protocol) server — auto-generated from the same OpenAPI spec as `@avallon-labs/sdk`.

## Usage

### Environment variables

| Variable               | Required | Default                    | Description                        |
| ---------------------- | -------- | -------------------------- | ---------------------------------- |
| `AVALLON_API_KEY`      | Yes\*    | —                          | API key (`x-api-key` header)       |
| `AVALLON_ACCESS_TOKEN` | Yes\*    | —                          | Bearer token (`Authorization`)     |
| `AVALLON_BASE_URL`     | No       | `https://api.avallon.ai`   | Override the API base URL          |

\*One of `AVALLON_API_KEY` or `AVALLON_ACCESS_TOKEN` is required. Bearer token takes precedence when both are set.

### Via npx

```bash
AVALLON_API_KEY=your-api-key npx @avallon-labs/mcp
```

### MCP client configuration

Add to your MCP client config (e.g., Claude Desktop `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "avallon": {
      "command": "npx",
      "args": ["@avallon-labs/mcp"],
      "env": {
        "AVALLON_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Development

### Regenerate from OpenAPI spec

```bash
# From the repo root:
npm run mcp:gen

# Or from packages/mcp (docs must already be generated):
npm run generate
```

### Build

```bash
npm run build
```

### Test

```bash
npm run test
```