mcp · velocms — Claude Code MCP server: what it does, how to install
Drafts, edits, publishes, and moderates content on your VeloCMS blog straight from your AI coding assistant.
claude mcp add mcp -e VELOCMS_SITE_URL=<VELOCMS_SITE_URL> -e VELOCMS_API_KEY=<VELOCMS_API_KEY> -- npx -y @velocms/mcpWhat mcp does
This server connects your development workspace to the VeloCMS REST API. Every tool translates into a direct API endpoint request, verified with Zod schemas to catch invalid arguments before transmission. The assistant can list articles, fetch full entries, submit drafts, alter metadata, publish posts, or handle deletions. Beyond articles, it exposes actions to inspect media assets by MIME type, change comment approval states, and read public site properties.
API access mandates a VeloCMS Pro subscription or higher. Free accounts lack API permission, meaning any tool invocation fails immediately with an HTTP 403 status. Your generated API token must also hold appropriate scopes such as posts:write or comments:moderate.
The runtime operates over standard stdio using npx. If either VELOCMS_SITE_URL or VELOCMS_API_KEY is omitted from the environment variables, the program logs an error and exits immediately with code 1.
What it helps with
- draft and publish articles on a VeloCMS website
- update SEO titles and descriptions without opening the browser dashboard
- review and moderate incoming blog comments
- browse stored media files filtered by MIME format
Example prompts for the agent
- Create a draft post titled "Quarterly Update" with tags dev and release
- Publish the post with ID 14 and check its SEO fields
- Show all comments in pending status
How to install mcp
Platform CLI
claude mcp add mcp -e VELOCMS_SITE_URL=<VELOCMS_SITE_URL> -e VELOCMS_API_KEY=<VELOCMS_API_KEY> -- npx -y @velocms/mcpReplace <…> with your own values
Platform CLI
codex mcp add velocms-mcp --env VELOCMS_SITE_URL=<VELOCMS_SITE_URL> --env VELOCMS_API_KEY=<VELOCMS_API_KEY> -- npx -y @velocms/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"velocms-mcp": {
"command": "npx",
"args": [
"-y",
"@velocms/mcp"
],
"env": {
"VELOCMS_SITE_URL": "<VELOCMS_SITE_URL>",
"VELOCMS_API_KEY": "<VELOCMS_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"velocms-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@velocms/mcp"
],
"env": {
"VELOCMS_SITE_URL": "<VELOCMS_SITE_URL>",
"VELOCMS_API_KEY": "<VELOCMS_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e VELOCMS_SITE_URL=<VELOCMS_SITE_URL> -e VELOCMS_API_KEY=<VELOCMS_API_KEY> velocms-mcp npx -y @velocms/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How to install mcp in Claude Code?
Run claude mcp add mcp -e VELOCMS_SITE_URL=<VELOCMS_SITE_URL> -e VELOCMS_API_KEY=<VELOCMS_API_KEY> -- npx -y @velocms/mcp with your actual blog URL and token.
What does this MCP server do?
It maps VeloCMS endpoints into LLM-callable actions, letting you draft articles, change publication states, moderate discussion threads, and check site configurations.
What subscription plan does VeloCMS require for this server?
You need a Pro tier or above. Lower tiers cannot generate valid API keys, causing the service to return HTTP 403 errors.
Similar MCP servers
All MCP servers for Backend and APIs →mcp by other authors comes first.
