ThinCMS MCP Server

MCP (Model Context Protocol) server for ThinCMS. Gives AI agents typed tool access to your ThinCMS site — no HTTP boilerplate, no header construction, no JSON encoding.

What it does

Wraps the ThinCMS REST API as 45 typed tools that any MCP-compatible AI client can call directly. Instead of constructing HTTP requests, agents call tools like thincms_create_post(title, content, status) and get structured responses back.

Requirements

• Node.js 18+
• A running ThinCMS instance
• An API key from ThinCMS (Admin > API Keys)
• An MCP-compatible client (Claude Desktop, Claude Code, VS Code, etc.)

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "thincms": {
      "command": "npx",
      "args": ["tsx", "/path/to/thincms-mcp/src/index.ts"],
      "env": {
        "THINCMS_BASE_URL": "https://your-domain.com",
        "THINCMS_API_KEY": "tcms_your_key_here",
        "THINCMS_SITE_ID": "your_site_id_here"
      }
    }
  }
}

Claude Code

Same configuration in .claude/settings.json or global Claude Code settings.

Available tools

Group	Tools
Posts	list_posts, get_post, create_post, update_post, delete_post, bulk_create_posts
Pages	list_pages, get_page, create_page, update_page, delete_page
Categories	list_categories, create_category, update_category, delete_category
Authors	list_authors, create_author, update_author, delete_author
Tags	list_tags, create_tag
Media	list_media, get_media, upload_media, update_media, delete_media
Template	get_template, update_template
Navigation	get_navigation, update_navigation
Settings	get_settings (read-only)
Scripts	list_scripts, create_script, update_script
Secrets	list_secrets, create_secret
Forms	list_forms, get_form, create_form, update_form
Submissions	list_submissions, export_submissions_csv
Search	search
Preview	create_preview, get_preview_url

All tool names are prefixed with thincms_ (e.g., thincms_list_posts).

Permissions

Uses the same API key auth as the REST API. API keys grant editor-level access — full CRUD on content, forms, templates, navigation, scripts, and secrets. Cannot change site settings, manage users, or run imports/backups.

Development

npm install
npm run build     # Compile TypeScript
npm run dev       # Run with tsx (for development)

License

MIT