BCMS Headless CMS for Openclaw

A powerful skill enabling AI coding agents to model content, integrate framework frontend code, and operate headless CMS operations using the BCMS SDK and Model Context Protocol (MCP).

bcms
v1.3.2
Jun 9, 2026
0
534
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install bcms

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install bcms using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is BCMS Headless CMS?

The BCMS Headless CMS skill empowers AI coding agents to build modern web applications and perform seamless content operations. By bridging the gap between developers, AI assistants, and content management, this integration allows agents to interact with BCMS using either the @thebcms/client TypeScript SDK or the dedicated Model Context Protocol (MCP) server. This setup facilitates efficient schema creation, content updates, and media handling directly within AI-assisted IDE environments like Cursor and Claude Code, making it a premier choice among Openclaw Skills.

Using this skill, agents can programmatically manage templates, entries, groups, widgets, and media libraries. It ensures strict compliance with security best practices, such as isolating three-part API keys (keyId.secret.instanceId) and enforcing least-privilege permissions, while optimizing rendering via official frontend components like BCMSContentManager and BCMSImage.

BCMS Headless CMS Use Cases

  • Accelerating frontend-web-dev project initialization by generating framework starters (Next.js, Nuxt, Astro, Svelte, Vite) pre-configured with headless CMS integrations.
  • Streamlining content operations directly from AI-driven coding environments using the BCMS MCP server for CRUD workflows on entries, templates, and groups.
  • Automating media asset optimization and upload pipelines using scoped API keys with the aid of Openclaw Skills.
  • Designing and evolving complex content schemas (templates, nested groups, and reusable rich-text widgets) safely without breaking production environments.
  • Securing serverless Functions and Webhooks with signature validation and cryptographic timestamp checks.

How BCMS Headless CMS Works

  1. Initialization: The AI agent reads the localized environment variables to initialize the @thebcms/client using a secure, three-part API key (keyId.secret.instanceId) or public-safe key configurations.
  2. Schema Modeling: The agent defines templates (e.g., blogs, pages) and builds reusable structures using groups (nested metadata) and widgets (embedded rich-text elements).
  3. Content Operations (MCP): If MCP tools are configured, the agent establishes a Streamable HTTP connection to the BCMS server to fetch, create, update, or delete entries and media.
  4. Frontend Integration: The agent generates or modifies frontend components, using official rendering libraries (like BCMSContentManager or BCMSImage) to handle localized rich text and assets.
  5. Deployment & Automation: Webhooks and serverless Functions are configured to trigger rebuilds or sync content across external platforms automatically. This standardizes content delivery workflows across all Openclaw Skills.

BCMS Headless CMS Setup

To get started with this skill, install the official BCMS client SDK in your framework project:

npm install @thebcms/client

Configure your environment variables inside a .env or .env.local file. Ensure you never hardcode secrets:

# Private administrative key (for server/build processes)
BCMS_API_KEY='keyId.secret.instanceId'

# Public/Browser-safe key (e.g., for Next.js)
NEXT_PUBLIC_BCMS_API_KEY='publicKeyId.publicSecret.instanceId'

For MCP integration in AI assistants (such as Cursor or Claude Code), append the following MCP connection configuration string utilizing your dedicated API key:

https://app.thebcms.com/api/v3/mcp?mcpKey=<keyId.secret.instanceId>

Run the local TypeScript scripts for client initialization or function calling to verify connectivity:

npx tsx ai/scripts/init-client.ts

BCMS Headless CMS Data Schema & Taxonomy

This skill organizes its content metadata and configurations using a highly structured schema. Below is the main taxonomy of BCMS components and generated files:

Component Description Local Data / Generated Output
Templates Content models defining structured fields (e.g., blog, page, author). Managed via dashboard or MCP; synced locally via CLI.
Entries Specific instances of templates containing localized meta and content fields. Resolved dynamically at build/runtime.
Groups Reusable, nested structures utilized within templates or widgets. Stored as custom property fields.
Widgets Rich-text blocks designed for landing page elements (e.g., CTAs, galleries). Rendered via BCMSContentManager.
Media Folder-structured asset library files (images, PDFs, SVGs). Optimized variants and responsive image source sets.

When running the CLI generator, TypeScript types are automatically pulled into your codebase:

  • Generated Types Location: bcms/types/ts or customized aliases mapped to @thebcms/types.
  • Local automation helper scripts: Located under ai/scripts/init-client.ts and ai/scripts/call-function.ts.

BCMS Headless CMS Advanced Features

  • Model Context Protocol (MCP) Server: Provides native kebab-case tool bindings for Cursor and Claude Code, allowing full CRUD operations, media uploads, and pointer links directly via the LLM.
  • Multilingual Content Modeling: Built-in support for localized meta and content structures processed smoothly by Openclaw Skills configurations.
  • Secure Webhook Verification: Cryptographic check on the X-Bcms-Webhook-Signature header and validation of timestamps to prevent replay attacks.
  • Custom Serverless Functions: REST-addressable custom backend logic hosted on BCMS, triggerable directly using authorized SDK methods.
  • Dependency Inspection: Methods like group.whereIsItUsed and widget.whereIsItUsed prevent destructive schema modifications in production environments.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*