DevHub CMS

You can use the DevHub CMS MCP to manage blog content, site data, and locations within DevHub CMS from your preferred MCP client. It exposes a set of tools for retrieving and updating blog posts, managing businesses and locations, and handling media. This guide walks you through how to use the server, how to install it locally, and important configuration notes to keep your integration secure and reliable.

How to use

Interact with the DevHub CMS MCP from your MCP client to perform common content and data tasks. You can fetch and update blog posts, list and modify businesses and locations, manage hours of operation, upload media, and resolve site details from a URL. When you request data, you’ll typically receive structured responses such as lists of businesses, detailed location data, or HTML content for posts. When you update content, ensure you pass the required fields (for example, a blog post title and HTML content) in the appropriate call so changes are saved correctly.

How to install

Prerequisites you need before installing: a working Python environment and the uv package manager. You should have Python installed and accessible in your shell, and you must have uv available to run the MCP server locally.

Install the MCP locally by following steps that align with your preferred development setup. The code samples show how to configure and run the server locally with the uv tool. Follow the exact command flows below to ensure the server runs correctly in your environment.

If you are using Claude Desktop, Cursor, Claude Code, or Smithery, use the respective configuration blocks shown in the installation examples to enable the MCP in your client. Update the environment variables with your DevHub credentials and base URL, then start the MCP using the provided commands.

Configuration and security notes

Configuration for local development is shown in explicit code blocks. You will define the MCP server in your client’s settings, supplying your API key, API secret, and the base URL for your DevHub instance. Protect these credentials and avoid sharing them in public forums or repositories. Use the exact commands and environment variable names shown to ensure proper authentication and connectivity.

Two common local development configurations are provided. The first runs the MCP through uvx with an explicit directory and module, while the second shows a standard uv run approach. Each configuration includes the necessary API credentials and base URL to connect to your DevHub data.

Troubleshooting and tips

If you encounter connectivity issues, verify that your DEVHUB_BASE_URL points to the correct frontend URL for your brand, and confirm that DEVHUB_API_KEY and DEVHUB_API_SECRET are valid. Ensure the environment variables are loaded in the client you are using (Claude Desktop, Cursor, Claude Code, or Smithery) and that the MCP process has permission to access network resources.

When updating content via the MCP, ensure you pass complete required fields for each operation (for example, a blog post creation requires a site_id, title, and HTML content). If a request fails due to missing fields, review the function’s signature and supply the required parameters in your call.

Notes

The DevHub CMS MCP is designed to be used with MCP-capable clients. It enables you to manage content and related data through a consistent interface without embedding API access directly into your LLMs. Use the provided tools to carry out common content operations and data retrieval against your DevHub CMS instance.

References and versioning

For local development, the code paths indicate how to run the server using the uv tool, with the main module specified for development. Follow the exact commands shown to reproduce the local workflow across environments.

Available tools

get_blog_post

Retrieve a blog post by ID including its title, date, and HTML content.

create_blog_post

Create a new blog post with a site ID, title, and HTML content.

update_blog_post

Update an existing blog post's title and/or content.

get_businesses

List all businesses in the DevHub account with IDs and names.

get_locations

Get all locations for a given business with detailed location data.

get_hours_of_operation

Fetch hours of operation for a location.

update_hours

Update hours of operation for a location.

get_nearest_location

Find the nearest location to given coordinates.

site_from_url

Resolve a DevHub site from a URL to get the site ID and related locations.

upload_image

Upload an image to the DevHub media gallery from a base64 string.