headlesshost-mcp MCP Server

A Model Context Protocol (MCP) server that provides complete communication with the Headlesshost platform API. This server enables AI assistants to manage content sites, staging sites, pages…

Local serverstdioMIT

What is the headlesshost-mcp Server?

headlesshost-mcp is an MCP project maintained in the headlesshost/mcp-server repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that provides complete communication with the Headlesshost platform API. This server enables AI assistants to manage content sites, staging…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares HEADLESSHOST_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
pingTest authentication and connection
healthCheck API health status
get_ref_dataGet system reference data and lookups
create_userCreate a new user in the current account
get_userGet user details by ID
update_userUpdate user information and claims
delete_userDelete a user from the system
create_accountCreate a new user account
get_accountGet current account information
update_accountUpdate account information
upload_user_profile_imageUpload a profile image for a user
upload_staging_site_fileUpload a file to a staging site
upload_staging_site_imageUpload an image to a staging site
create_content_siteCreate a new content site
get_content_sitesGet all content sites in the account
get_content_siteGet content site details by ID
update_content_siteUpdate content site information
delete_content_siteDelete a content site
update_staging_siteUpdate staging site information
delete_staging_siteDelete a staging site
publish_staging_sitePublish a staging site to make it live
get_staging_siteGet staging site details
get_staging_site_pagesGet staging site pages
get_staging_site_configurationGet staging site configuration including section types
get_staging_site_logsGet change logs since last publish
get_published_sitesGet published sites for a content site
revert_staging_siteRevert a staging site to a previous state
clone_staging_siteClone a staging site
create_staging_site_pageCreate a new page
get_staging_site_pageGet page details (with optional sections)
update_staging_site_pageUpdate a page
delete_staging_site_pageDelete a page
revert_staging_site_pageRevert a page to a previous state
get_staging_site_page_logsGet page change logs since last publish
create_staging_site_sectionCreate a new section in a page
get_staging_site_sectionGet section details
update_staging_site_sectionUpdate a section
delete_staging_site_sectionDelete a section
publish_staging_site_sectionPublish a single section
revert_staging_site_sectionRevert a section to a previous state
get_staging_site_section_logsGet section change logs since last publish
create_staging_site_audienceCreate an audience (locale/segment combination) for a site
get_staging_site_audienceGet audience details
update_staging_site_audienceUpdate an audience
delete_staging_site_audienceDelete an audience (base audience cannot be deleted)
create_staging_site_section_audienceCreate an audience override for a section
get_staging_site_section_audienceGet section audience details
update_staging_site_section_audienceUpdate a section audience override
delete_staging_site_section_audienceDelete a section audience override
get_content_site_logsGet the last 15 activity logs
get_content_site_hitsGet daily hit analytics
get_content_site_accountsGet associated accounts
get_content_site_claimsGet current user claims

How to install the headlesshost-mcp Server

{
  "mcpServers": {
    "headlesshost-cms": {
      "command": "node",
      "args": [
        "/path/to/kapiti.mcp/build/index.js"
      ],
      "env": {
        "HEADLESSHOST_API_KEY": "YOUR_HEADLESSHOST_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
HEADLESSHOST_API_KEYDeclared in the maintainer’s client configuration.Check documentation