basercms

This MCP server provides a Model Context Protocol interface to control baserCMS through its Web API, enabling natural language actions via MCP clients like GitHub Copilot or Claude in agent mode. It authenticates with the baserCMS API and exposes endpoints to manage blogs, custom content, and system information, turning conversational commands into concrete CMS actions.

How to use

Connect to one of the MCP clients you use (for example, GitHub Copilot, Cline, or Claude Desktop) and interact with baserCMS through natural language prompts. You can create, search, edit, and delete blog posts and categories, manage custom content and entries, and fetch system information using plain language. The MCP server translates your requests into corresponding API calls to baserCMS and returns results or confirmations.

How to install

Prerequisites: you need Node.js installed on your machine. Ensure you have npm available to install dependencies.

1. Install the MCP package for baserCMS on your system.

npm install @ecatchup/basercms-mcp

Additional sections

Configuration You must provide access to the baserCMS Web API. Create a local environment file and set the following environment variables.

API_BASE_URL=http://your-baser CMS-url/
API_USER=your-baserCMS-user@example.com
API_PASSWORD=your-secure-password

Configuration for client integrations

For GitHub Copilot, create the MCP server entry in the Copilot configuration to point to the local MCP runtime.

Notes on usage and capabilities

When you issue prompts, the MCP server performs actions such as fetching blog posts by ID, listing posts with search and paging, adding or editing posts and categories, and managing custom content structures like custom tables, fields, and entries. You can also retrieve server information to verify the running version and environment.

Available tools

getBlogPost

Fetch a blog post by ID from blog posts (bc-blog).

getBlogPosts

List blog posts with optional search and paging.

addBlogPost

Create a new blog post under bc-blog.

editBlogPost

Update an existing blog post in bc-blog.

deleteBlogPost

Remove a blog post from bc-blog.

getBlogCategory

Fetch a specific blog category by ID in bc-blog.

getBlogCategories

List blog categories in bc-blog.

addBlogCategory

Create a new blog category in bc-blog.

editBlogCategory

Update a blog category in bc-blog.

deleteBlogCategory

Delete a blog category in bc-blog.

getBlogContent

Fetch a blog content item by ID in bc-blog.

getBlogContents

List blog contents in bc-blog.

addBlogContent

Create a new blog content item in bc-blog.

editBlogContent

Update a blog content item in bc-blog.

deleteBlogContent

Delete a blog content item in bc-blog.

getBlogTag

Fetch a blog tag by ID in bc-blog.

getBlogTags

List blog tags in bc-blog.

addBlogTag

Create a new blog tag in bc-blog.

editBlogTag

Update a blog tag in bc-blog.

deleteBlogTag

Delete a blog tag in bc-blog.

getCustomTable

Fetch a custom table by ID in bc-custom-content.

getCustomTables

List custom tables in bc-custom-content.

addCustomTable

Create a new custom table in bc-custom-content.

editCustomTable

Update a custom table in bc-custom-content.

deleteCustomTable

Delete a custom table in bc-custom-content.

getCustomField

Fetch a custom field by ID in bc-custom-content.

getCustomFields

List custom fields in bc-custom-content.

getIndexCustomFields

Fetch index-facing custom fields in bc-custom-content.

addCustomField

Create a new custom field in bc-custom-content.

editCustomField

Update a custom field in bc-custom-content.

deleteCustomField

Delete a custom field in bc-custom-content.

getCustomEntry

Fetch a custom entry by ID in bc-custom-content.

getCustomEntries

List custom entries in bc-custom-content.

addCustomEntry

Create a new custom entry in bc-custom-content (supports file uploads).

editCustomEntry

Update a custom entry in bc-custom-content.

deleteCustomEntry

Delete a custom entry in bc-custom-content.

getCustomContent

Fetch a custom content item by ID in bc-custom-content.

getCustomContents

List custom contents in bc-custom-content.

addCustomContent

Create a new custom content item in bc-custom-content.

editCustomContent

Update a custom content item in bc-custom-content.

deleteCustomContent

Delete a custom content item in bc-custom-content.

getCustomLink

Fetch a custom link by ID in bc-custom-content.

getCustomLinks

List custom links in bc-custom-content.

addCustomLink

Create a new custom link in bc-custom-content.

editCustomLink

Update a custom link in bc-custom-content.

deleteCustomLink

Delete a custom link in bc-custom-content.

serverInfo

Retrieve server version and environment information