Agent tools

MCP Quick Start

Connect Claude, Cursor, Codex, Cline, Windsurf, Zed, and other agents to StaticX with one scoped API token.

API-token-first MCP

Deploy static websites from any AI agent.

StaticX uses scoped API tokens for MCP because it is built for automation, CI/CD, and AI agents. Create a narrow token, add one config, and let the agent use explicit StaticX tools.

Install

npx

Auth

API token

Clients

Any MCP

Create a scoped token

For one site, choose a site token with a short expiry. The token is shown once and can be revoked at any time.

Add the MCP server

Paste the config below into your agent. Keep the placeholder in shared files and inject the real token locally.

Ask for a safe deploy

Ask the agent to build, verify index.html and 404.html, call staticx_deploy_zip, and return the live URL.

Install the MCP

Pick your agent, copy the snippet, and paste it into the client configuration. StaticX authenticates with a scoped API token you can expire or revoke at any time.

staticx-mcp-server on GitHub

Claude Code Terminal

claude mcp add staticx --scope user \
  --env STATICX_API_TOKEN=sx_replace_with_your_token \
  --env STATICX_API_BASE_URL=https://staticx.site/api/v1 \
  -- npx -y staticx-mcp-server

Cursor ~/.cursor/mcp.json

{
    "mcpServers": {
        "staticx": {
            "command": "npx",
            "args": [
                "-y",
                "staticx-mcp-server"
            ],
            "env": {
                "STATICX_API_TOKEN": "sx_replace_with_your_token",
                "STATICX_API_BASE_URL": "https://staticx.site/api/v1"
            }
        }
    }
}

Codex Terminal

codex mcp add staticx \
  --env STATICX_API_TOKEN=sx_replace_with_your_token \
  --env STATICX_API_BASE_URL=https://staticx.site/api/v1 \
  -- npx -y staticx-mcp-server

Cline ~/.cline/mcp.json

{
    "mcpServers": {
        "staticx": {
            "command": "npx",
            "args": [
                "-y",
                "staticx-mcp-server"
            ],
            "env": {
                "STATICX_API_TOKEN": "sx_replace_with_your_token",
                "STATICX_API_BASE_URL": "https://staticx.site/api/v1"
            }
        }
    }
}

Windsurf ~/.codeium/windsurf/mcp_config.json

{
    "mcpServers": {
        "staticx": {
            "command": "npx",
            "args": [
                "-y",
                "staticx-mcp-server"
            ],
            "env": {
                "STATICX_API_TOKEN": "sx_replace_with_your_token",
                "STATICX_API_BASE_URL": "https://staticx.site/api/v1"
            }
        }
    }
}

Claude Desktop Settings > Developer > Edit Config

{
    "mcpServers": {
        "staticx": {
            "command": "npx",
            "args": [
                "-y",
                "staticx-mcp-server"
            ],
            "env": {
                "STATICX_API_TOKEN": "sx_replace_with_your_token",
                "STATICX_API_BASE_URL": "https://staticx.site/api/v1"
            }
        }
    }
}

Zed ~/.config/zed/settings.json · context_servers

{
    "context_servers": {
        "staticx": {
            "command": "npx",
            "args": [
                "-y",
                "staticx-mcp-server"
            ],
            "env": {
                "STATICX_API_TOKEN": "sx_replace_with_your_token",
                "STATICX_API_BASE_URL": "https://staticx.site/api/v1"
            }
        }
    }
}

Continue ~/.continue/config.json · modelContextProtocolServers

{
    "mcpServers": {
        "staticx": {
            "command": "npx",
            "args": [
                "-y",
                "staticx-mcp-server"
            ],
            "env": {
                "STATICX_API_TOKEN": "sx_replace_with_your_token",
                "STATICX_API_BASE_URL": "https://staticx.site/api/v1"
            }
        }
    }
}

Local HTTP Streamable HTTP debugging

STATICX_API_TOKEN=sx_replace_with_your_token \
STATICX_API_BASE_URL=https://staticx.site/api/v1 \
npx -y staticx-mcp-server http

# Connect a Streamable HTTP client to:
http://localhost:3100/mcp

Need a scoped token? Create a free account and connect your agent in minutes.

First prompt

Give the agent a clear finish line.

Use StaticX MCP to deploy this static website.

Before deploying:
- build the project
- verify index.html and 404.html exist at the build root
- explain what you will publish

After deploying:
- return the live URL and release
- inspect logs if anything fails
- stop on PLAN_QUOTA_EXCEEDED and show the exact quota message
- do not roll back or delete anything without asking me first

Keep secrets out of shared config.

Never commit a real token. Use the placeholder in examples, then store the real value only in your local client configuration or environment.