Enables AI clients to discover, evaluate, and validate generated websites using the CodeY CMS builder registry and WebsiteSpec 1.0.
Also known as fpointerdev/codey-cms, codey-cms, codey-cms-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.1
- Last commit
- Nov 9, 2026
- License
- GPL-2.0
What is CodeY CMS MCP?
CodeY CMS enables AI clients to discover, evaluate, and validate generated websites using the CodeY CMS builder registry and WebsiteSpec 1.0.
Summary generated from the project's README
About CodeY CMS MCP server
CodeY CMS provides a read-only Model Context Protocol server designed for AI clients to interact with the CodeY CMS ecosystem. It allows developers to discover and evaluate website configurations through a builder registry and the WebsiteSpec 1.0 standard. The server exposes specific tools for searching documentation, evaluating project fit, and accessing signed installation plans to ensure generated websites meet required specifications.
Users can run this server locally using npx or deploy it via Streamable HTTP. When deploying publicly, administrators must configure an explicit host allowlist using the CODEY_MCP_ALLOWED_HOSTS environment variable to prevent unauthorized access. The server is strictly read-only and does not connect to customer databases or modify existing CMS installations. For containerized environments, a pinned non-root Docker build is available to facilitate secure deployment.
What you can do with it
- 1Validate website specificationsAn AI client can check if a generated website adheres to the required standards using the WebsiteSpec 1.0 validation tool.
- 2Discover available website buildersA developer can ask an AI to find compatible builders within the official registry.
- 3Evaluate project compatibilityYou can use the server to determine if a specific project aligns with the capabilities of the CMS.
Written from the project's README. Every use case is checked against a quote from it.
How to install CodeY CMS MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall CodeY CMS MCP in Claude Code
$ claude mcp add codey-cms -- npx -y codey-cms-mcpInstall CodeY CMS MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"codey-cms": {
"command": "npx",
"args": [
"-y",
"codey-cms-mcp"
]
}
}
}Install CodeY CMS MCP in VS Code
.vscode/mcp.json
{
"servers": {
"codey-cms": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codey-cms-mcp"
]
}
}
}Install CodeY CMS MCP in VS Code CLI
$ code --add-mcp '{"name":"codey-cms","type":"stdio","command":"npx","args":["-y","codey-cms-mcp"]}'Install CodeY CMS MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"codey-cms": {
"command": "npx",
"args": [
"-y",
"codey-cms-mcp"
]
}
}
}Install CodeY CMS MCP in Codex
$ codex mcp add codey-cms -- npx -y codey-cms-mcpInstall CodeY CMS MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.codey-cms] command = "npx" args = ["-y", "codey-cms-mcp"]
Install CodeY CMS MCP in Gemini CLI
$ gemini mcp add -s user codey-cms npx -- -y codey-cms-mcpInstall CodeY CMS MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"codey-cms": {
"command": "npx",
"args": [
"-y",
"codey-cms-mcp"
]
}
}
}Configuration
CODEY_MCP_ALLOWED_HOSTSCODEY_MCP_HOST
| Name | Description | |
|---|---|---|
| CODEY_MCP_ALLOWED_HOSTS | — | |
| CODEY_MCP_HOST | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablefpointerdev/codey-cms is public and reachablegithub.com/fpointerdev/codey-cms ↗Pass
- Package names this repository as its sourcecodey-cms-mcp names fpointerdev/codey-cms as sourcenpmjs.com/package/codey-cms-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for codey-cms-mcpnpmjs.com/package/codey-cms-mcp/v/0.1.1#provenance ↗Pass
- Open source license (OSI)GPL-2.0spdx.org/licenses/GPL-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/fpointerdev/codey-cms ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from codey-cms-mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubCodeY CMS MCP
Read-only Model Context Protocol server for discovering and evaluating CodeY CMS from canonical product contracts.
It exposes product capabilities, documentation search, responsible project-fit evaluation, the signed installation plan, the builder registry, and WebsiteSpec 1.0 validation. It cannot connect to customer databases or modify a CMS installation.
Run locally
npx -y codey-cms-mcp
Client configuration:
{
"mcpServers": {
"codey-cms": {
"command": "npx",
"args": ["-y", "codey-cms-mcp"]
}
}
}
Serve through Streamable HTTP
Loopback is the default:
npx -y codey-cms-mcp --http --port 8787
Public deployment requires an explicit host allowlist:
CODEY_MCP_HOST=0.0.0.0 \
CODEY_MCP_ALLOWED_HOSTS=usecodey.com \
PORT=8787 \
npx -y codey-cms-mcp --http
List hostnames without schemes or ports. Loopback hostnames remain available for container health checks, while other host headers are rejected.
Terminate TLS and apply service-level rate limits at the reverse proxy. The public server is intentionally read-only. A future authenticated site-management connector must use OAuth, CMS role checks, user confirmation, and audit logging rather than extending this anonymous server.
The repository also contains a pinned, non-root container build:
docker build -f integrations/codey-cms-mcp/Dockerfile -t codey-cms-mcp .
docker run --rm -p 127.0.0.1:8787:8787 \
-e CODEY_MCP_ALLOWED_HOSTS=127.0.0.1 \
codey-cms-mcp
Maintainer checks
From the CodeY CMS repository root:
pnpm mcp:test
pnpm mcp:build
pnpm mcp:pack
MCP Registry name: io.github.fpointerdev/codey-cms
CodeY CMS MCP questions
How do I add CodeY CMS MCP to Claude Code?
Run claude mcp add codey-cms -- npx -y codey-cms-mcp in your terminal. Add --scope user to make it available in every project.
How do I add CodeY CMS MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can this server modify my CMS installation?
No, the server is read-only and cannot connect to customer databases or modify a CMS installation.
How can I run the server locally?
You can run it locally using the command npx -y codey-cms-mcp.
Is the server capable of site management?
The current server is intentionally read-only; future authenticated site-management will require OAuth and CMS role checks.