# woodpecker-mcp

MCP server for interacting with Woodpecker CI 3.13.0+.

Source: [`@devpuccino/mcp-woodpecker`](https://www.npmjs.com/package/@devpuccino/mcp-woodpecker)

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `WOODPECKER_URL` | Yes | Base URL of the Woodpecker instance (e.g. `https://woodpecker.corentic.eu`) |
| `WOODPECKER_API_KEY` | Yes | Woodpecker API key with required scopes |

## Usage

```bash
docker run -d \
  --name woodpecker-mcp \
  -p 8102:8102 \
  -e WOODPECKER_URL=https://woodpecker.corentic.eu \
  -e WOODPECKER_API_KEY=your_key_here \
  forgejo.corentic.eu/corentic/mcp-fleet-woodpecker:latest
```

## Tools

- `activate_repository`
- `cancel_pipeline`
- `create_cron`
- `create_org_secret`
- `create_registry`
- `create_secret`
- `delete_cron`
- `delete_org_secret`
- `delete_pipeline_logs`
- `delete_registry`
- `delete_repository`
- `delete_secret`
- `get_cron`
- `get_current_user`
- `get_org_secret`
- `get_pipeline`
- `get_pipeline_logs`
- `get_pipeline_status`
- `get_registry`
- `get_repository`
- `get_secret`
- `list_crons`
- `list_org_secrets`
- `list_pipelines`
- `list_registries`
- `list_repositories`
- `list_secrets`
- `lookup_organization`
- `trigger_pipeline`
- `update_cron`
- `update_org_secret`
- `update_repository`
- `update_secret`