pingLABSCO SUMMARY
The whole platform API, with the dangerous calls labelled.
This is a full management surface — it creates and deletes users and accounts, not just content. The annotations are what makes that comfortable: the client knows which calls are read-only and which are destructive before it runs one.
What it is
A server over the Headlesshost platform API, covering content sites, staging sites, pages, sections, audiences, users and file uploads. Built on MCP SDK v1.26 with Zod-validated inputs, and every tool carries annotations — read-only, destructive, idempotent — so a client can prompt for confirmation where it matters.
What you get
- Content sites created, fetched one at a time, or listed
- Accounts created, read and updated
- Users created, read, updated and deleted
- Files and images uploaded to a staging site before it goes live
- Profile images uploaded for a user
- System reference data and lookups, for the values the other calls expect
- Tool annotations on every call, so destructive operations are marked as such to the client
Requirements
A Headlesshost API key, supplied in the environment. Runs through npx as headlesshost-mcp-server, or from a local build with node. Works with any MCP client, not only Claude Desktop.
Setup effort
One command plus a key — npx headlesshost-mcp-server@latest, then supply credentials
USE CASES
01
Standing up a new site
Create the content site, then read it back to confirm what the platform actually recorded.
02
Staging a release before it goes live
Upload the files and images to the staging site, so the change is reviewable rather than immediate.
03
Adding someone to the platform
Create the user, set their details and give them a profile image in one pass.
04
Taking stock of what an account owns
Read the account and list the content sites under it before making changes.
05
Off-boarding cleanly
Read the user first to be sure of who it is, then delete them.
06
Filling in the fields a call expects
Pull the system reference data and lookups so values are the platform's own, not guessed.
53 tools
Listed in project docs. Your client may show a different list.
healthget_ref_datacreate_userget_userupdate_userdelete_usercreate_accountget_accountupdate_accountupload_user_profile_imageupload_staging_site_fileupload_staging_site_imagecreate_content_siteget_content_sitesget_content_siteupdate_content_sitedelete_content_siteupdate_staging_sitedelete_staging_sitepublish_staging_siteget_staging_siteget_staging_site_pagesget_staging_site_configurationget_staging_site_logsget_published_sitesrevert_staging_siteclone_staging_sitecreate_staging_site_pageget_staging_site_pageupdate_staging_site_pagedelete_staging_site_pagerevert_staging_site_pageget_staging_site_page_logscreate_staging_site_sectionget_staging_site_sectionupdate_staging_site_sectiondelete_staging_site_sectionpublish_staging_site_sectionrevert_staging_site_sectionget_staging_site_section_logscreate_staging_site_audienceget_staging_site_audienceupdate_staging_site_audiencedelete_staging_site_audiencecreate_staging_site_section_audienceget_staging_site_section_audienceupdate_staging_site_section_audiencedelete_staging_site_section_audienceget_content_site_logsget_content_site_hitsget_content_site_accountsget_content_site_claimsBEFORE YOU INSTALL
What to know first
Tools you get
53 tools named in the project's documentation.
Requires
- npx on PATH
- HEADLESSHOST_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx headlesshost-mcp-server@latestMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"headlesshost-cms": {
"command": "npx",
"args": [
"headlesshost-mcp-server@latest"
],
"env": {
"HEADLESSHOST_API_KEY": "<YOUR_HEADLESSHOST_API_KEY>"
}
}
}
}
