A Widget Context Protocol (WCP) widget that brings your Cloudflare account into any WCP-compatible dashboard. View Workers and their bound domains, browse zones and DNS records, and manage API credentials — all without leaving the dashboard.
Specification: widgetcontextprotocol.com | Part of the Penrith Beacon WCP widget suite.
WCP 2.1.0 certified. Full theme reception, orchestration-aware state, Publish to Web, WCP export.
| Component | Default size | Description |
|---|---|---|
| Workers | 12x6 | Cloudflare Workers with bound domains |
| Domains + DNS | 12x6 | Zones list + DNS records |
| Settings | 12x6 | API Token, Account ID, Worker repo mappings |
| Help | 12x6 | Setup guide, FAQ, reference links |
docker run -d \
--name wcp-widget-cloudflare \
-p 3742:3742 \
-v cf-data:/app/data \
-v cf_published:/app/published \
-e CONTAINER_NAME=wcp-widget-cloudflare \
--restart unless-stopped \
docker.io/penrithbeacon/wcp-widget-cloudflare:latest
services:
cloudflare:
image: docker.io/penrithbeacon/wcp-widget-cloudflare:latest
container_name: wcp-widget-cloudflare
ports:
- "3742:3742"
volumes:
- cf-data:/app/data
- ./published:/app/published
environment:
- CONTAINER_NAME=wcp-widget-cloudflare
restart: unless-stopped
volumes:
cf-data:
You need a Cloudflare Account ID and an API Token with these permissions:
| Resource | Permission |
|---|---|
| Zone > Zone | Read |
| Zone > DNS | Read |
| Account > Workers Scripts | Read |
| Account > Worker Routes | Read |
Create a token at My Profile > API Tokens. Then open the Settings component and paste both values in.
| Header | Required | Description |
|---|---|---|
Wcp-Instance-Id | Yes | Unique card instance identifier |
Wcp-Dashboard-Id | Yes | Dashboard installation identifier |
Wcp-Version | Yes | WCP protocol version of the requesting dashboard |
Wcp-Widget-Id | Yes | Widget identifier within the dashboard |
Wcp-Orchestration-Id | No | Active orchestration identifier (for state scoping) |
Wcp-Application-Id | No | Active application identifier (for state scoping) |
| Endpoint | Description |
|---|---|
GET /wcp | Container Directory — WCP two-tier discovery |
GET /widget/wcp | Widget Manifest with runtime publish status |
OPTIONS /wcp | CORS preflight (all widget routes) |
GET /widget/ | Compact widget card (iframe) |
GET /widget/index | Widget Index — lists all controls |
GET /widget/health | Health check with container name |
GET /widget/icon.svg | Widget icon (SVG) |
GET /widget/api/guids | Component UUIDs for orchestration binding |
GET /widget/workers | Workers component page |
GET /widget/domains | Domains + DNS component page |
GET /widget/settings | Settings component page |
GET /widget/help | Help component page |
POST /widget/configure | Save credentials and repo mappings |
GET /widget/api/config-status | Configuration status (token masked) |
GET /widget/api/workers | Workers list (30s cache) |
GET /widget/api/zones | Zones list (120s cache) |
GET /widget/api/dns/<zone_id> | DNS records for a zone (30s cache) |
GET /widget/export.wcp | Self-export as .wcp package |
POST /widget/publish | Accept SPA HTML for Publish to Web |
DELETE /widget/publish | Remove published SPA |
GET / | Serve published SPA (if present) |
| Property | Value |
|---|---|
| WCP Version | 2.1.0 |
| Widget Version | 1.4.0 |
| Render mode | iframe |
| Auth | None (credentials stored server-side) |
| Default card size | 12x6 |
| Multi-instance | Yes (per Instance-Id) |
| Property | Value |
|---|---|
| Base image | python:3.12-slim |
| Platforms | linux/amd64, linux/arm64 |
| Port | 3742 |
| Framework | Flask |
| Dependencies | Flask, requests |
| Persistent storage | Named volume for per-instance credentials |
| Tag | Description |
|---|---|
latest | Most recent stable release |
1.4.0-wcp2.1.0 | /widget/index directory page, audit compliance |
1.3.0-wcp2.1.0 | /widget/health returns container name |
1.2.0-wcp2.1.0 | WCP 2.1.0 upgrade, orchestration ID context |
1.1.0-wcp2.0.0 | Container block, manifest image source |
1.0.1-wcp1.4.0 | Server UUID, Container Directory, Wcp-Widget-Id |
1.0.0-wcp1.3.1 | Initial release |
Content type
Image
Digest
sha256:8c0a1ad44…
Size
47.2 MB
Last updated
4 months ago
docker pull penrithbeacon/wcp-widget-cloudflare