mcpField
K
krexel-mcp

krexel-mcp

Local
github.com/Syfer-webCloud & Infra0Updated 14w ago
Repository

About krexel-mcp

krexel-mcp is Krexel’s MCP server for deploying and editing static sites through MCP-compatible AI clients. Its tools cover site files, deployment history, rollbacks, environment variables, and status.

Key features

  1. 01Deploy built site folders
  2. 02Edit deployed files
  3. 03Inspect and read site files
  4. 04List deploys and view logs
  5. 05Rollback to a previous deploy
  6. 06Manage environment variables and status

Use cases

  1. 01Publish a built static site from an AI client
  2. 02Ask an AI to inspect and revise deployed files
  3. 03Restore a previous deployment after a change

MCP support

Exposes nine Krexel tools to MCP clients through standard tool discovery. The tools support deployments, file operations, logs, rollback, environment variables, and account status.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "syfer-web-krexel": {
      "command": "npx",
      "args": [
        "-y",
        "krexel-mcp"
      ]
    }
  }
}
Run commandnpx -y krexel-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmkrexel-mcp0.3.2

Tools

9

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
domainstringYesCustom domain to attach (e.g. shop.example.com).
folderstringYesAbsolute or ~-relative path to the built site directory.
frameworkenumNoBuild framework hint. Default 'auto' detects from package.json.auto | nextjs | astro | vite | static

Details

From the project README

krexel-mcp

Ship AND edit static sites from any AI assistant that speaks the Model Context Protocol.

krexel-mcp is the official MCP server for Krexel — a "your AI ships and edits your live site" API. Point any MCP-compatible client (Claude Desktop, Cursor, Windsurf, VS Code) at this server and your assistant can deploy, list, edit, rollback, and inspect sites just by talking.

Quickstart

Add krexel-mcp to your MCP client configuration:

{
  "mcpServers": {
    "krexel": {
      "command": "npx",
      "args": ["-y", "krexel-mcp"],
      "env": {
        "KREXEL_API_URL": "https://api.krexel.com",
        "KREXEL_API_KEY": "krx_live_••••••••••••••••",
        "KREXEL_MASTER_KEY": "<your-32-byte-hex-key>"
      }
    }
  }
}

Restart your client. The assistant now sees nine Krexel tools.

Tools

ToolWhat it does
ship_siteUpload a built site folder. Returns a deploy_id and preview URL.
edit_filePatch a deployed site (create / replace / replace_all / delete). 0.1 deploy.
list_filesList the files in a deployed site (path + size + sha256).
read_fileRead one file's content from a deployed site.
list_deploysList recent deploys from local state. Optional domain filter.
get_logsFetch build logs for a deploy.
rollbackMark a previous deploy as the current good version.
set_envEncrypt and persist an env var for a domain (AES-256-GCM).
get_statusReturn account, deploy count, plan, and state directory.
The conversational-edit flow
  1. AI calls list_files(deploy_id) to see what files exist on the site.
  2. AI calls read_file(deploy_id, path) to read the file it wants to change.
  3. AI generates the new content itself, then calls edit_file(deploy_id, op: "replace", file, find, value, message).
  4. Krexel ships the patch as a new deploy — live in ~8 seconds, 0.1 deploy against the customer's quota. The new deploy_id and parent_deploy_id are returned so the AI can chain further edits on top.

The AI is the brain. Krexel is the hands.

All tools take plain JSON arguments and return JSON. Tool schemas are discoverable via the standard MCP tools/list request.

Configuration

Env varRequiredDefaultNotes
KREXEL_API_URLnohttps://api.krexel.comBase URL of the Krexel orchestrator API.
KREXEL_API_KEYno*~/.krexel/auth.jsonAccount API key. Forwarded as Authorization: Bearer *** to every API call. *Required unless saved by krexel login.
KREXEL_MASTER_KEYyes*—32-byte hex string for env-var encryption. *Required for set_env.

State files are written under $KREXEL_HOME (default ~/.krexel/).

License

MIT © Syfer

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.