The Kapiti MCP Server enables AI assistants to interact comprehensively with the Headlesshost platform for complete content and site management.

Core System Operations: Test connectivity with ping/health checks, access system reference data, and utilize GPT Assistant for AI-powered tasks.

User & Account Management: Register users, perform full CRUD operations on accounts, manage roles/claims/permissions, upload profile images, and handle team management.

Content Site Administration: Create, list, update, and delete content sites with full lifecycle management. Access analytics including hit tracking, activity logs, daily hit data, and manage associated accounts and user claims.

Staging Site Management: Comprehensive staging operations including creation, updates, publishing, cloning, reverting, and deletion. Access detailed configurations, change logs, published versions, and manage permissions.

Page & Section Management: Full CRUD operations for pages within staging sites, including content updates and log access. Create, update, publish, revert, and delete sections with activity monitoring.

File Management: Upload files to staging sites and user profiles.

Advanced Features: AI-powered content generation, audience segmentation and targeting, content and product catalog management, style guide development, template creation and sharing, analytics and reporting, and business operations including invoicing, billing, and subscription management.

Headlesshost MCP Server

A comprehensive Model Context Protocol (MCP) server that provides complete communication with the Headlesshost platform API endpoints. This server enables AI assistants to interact with all aspects of the Headlesshost platform including user management, content site operations, staging site management, content generation, analytics, and system administration.

Demo

https://www.youtube.com/watch?v=xGGwcrI7gSo&feature=youtu.be

Installation

Clone this repository
Install dependencies:
npm install
Build the server:
npm run build

Usage

With Claude Desktop

Add this configuration to your Claude Desktop config file:

On a Mac (edit or create this file).

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

For local development

{ "mcpServers": { "Headlesshost-cms": { "command": "node", "args": ["/path/to/Headlesshost-mcp/build/index.js"], "env": { "HEADLESSHOST_API_KEY": "your-auth-token" } } } }

For automated install via npx

{ "mcpServers": { "headlesshost-cms": { "command": "npx", "args": ["headlesshost-mcp-server"], "env": { "HEADLESSHOST_API_KEY": "sk_live_your_api_key" } } } }

With Other MCP Clients

This server is compatible with any MCP client including:

VS Code with MCP extensions
Zed Editor
Continue.dev
Custom MCP implementations

Configure your client to use:

Command: node
Args: ["/path/to/Headlesshost.mcp/build/index.js"]
Environment: Set HEADLESSHOST_API_KEY

Development

Build the server:

npm run build

Run the server directly:

npm start

Run the MCP inspector for debugging:

npm run inspector

Resources

The server provides 2 resources for configuration and monitoring:

API Configuration: Current Headlesshost API settings and endpoints
API Health Status: Real-time connectivity and health information

Error Handling

The server includes comprehensive error handling with:

API authentication validation
Network connectivity checks
Detailed error messages and troubleshooting information
Graceful fallbacks for API timeouts

Security

API key authentication required for all operations
Secure environment variable handling
Request/response logging for audit trails
Input validation and sanitization

Kapiti MCP Server

Headlesshost MCP Server

Demo

Installation

Usage

With Claude Desktop

For local development

For automated install via npx

With Other MCP Clients

Development

Resources

Error Handling

Security

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API