thincms-mcp

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