Static.app MCP Server

What is Static.app MCP

The Static.app MCP (Model Context Protocol) server allows AI assistants to interact directly with your hosting platform. MCP is an open standard that enables AI tools to connect with third-party APIs in a secure and consistent way.

By connecting your AI assistants to Static.app, you can manage your static websites, upload files, download archives, and handle form submissions—all through natural conversation within your favorite AI client.

Most popular AI tools support connecting to the remote MCP directly. Here are the step-by-step setup guides for supported clients:

Claude Desktop
Claude Code
Cursor
Windsurf
Any client implementing the MCP specification

Prerequisites

Before setting up the connection, ensure you have the following ready:

API Access: A Static.app account with an active plan.
Static.app API Key: You must have an active API key to authenticate the server. You can generate and manage your keys in your dashboard by navigating to Account Settings → API Keys.
Compatible AI Client: An MCP-compatible AI application installed and ready to configure (see the list above).

Connect to Static.app MCP

Static.app provides a hosted MCP server. Use the following URL when prompted by your specific client configuration:

Connection URL

SSE Endpoint: https://mcp.static.app/sse

Claude Desktop (Anthropic's desktop app)

Claude Desktop uses stdio-based MCP servers. Use mcp-remote to bridge the remote HTTP endpoint.

Installation

Click on your profile icon in the lower-left corner of the Claude app and choose Settings from the menu.
In the Settings, select Developer under Desktop app and click Edit config.
This will open or locate the claude_desktop_config.json file.
Update your configuration in the following format:

{
  "mcpServers": {
    "static-app": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "[https://mcp.static.app/sse](https://mcp.static.app/sse)",
        "--header", "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Note: Replace YOUR_API_KEY with your actual API key. Restart Claude Desktop to apply.

Using Static.app with Claude

Enable the connector in the chat settings dropdown. Add a prompt, for example:

"Using Static.app, list all my websites and show me the file list for the site with PID '0aw4jtby1z'."

Claude Code (Anthropic's CLI for developers)

Claude Code uses a project-level configuration to manage MCP servers.

1. Setup the Project Configuration

In your project's root directory, create a file named .mcp.json .

Configuration:

{
  "mcpServers": {
    "static-app": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "[https://mcp.static.app/sse](https://mcp.static.app/sse)",
        "--header",
        "Authorization: Bearer ${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "sk_YOUR_API_KEY"
      }
    }
  }
}

2. Initializing the Connection

Launch Claude by typing claude in your terminal.
Type /mcp list to confirm the handshake. You should see static-app listed with a Connected status.

Cursor (AI-Native Code Editor)

Cursor uses the Streamable HTTP transport to maintain a connection to the remote API.

Installation

Open Cursor settings (Cmd + , or Ctrl + , ).

In the settings sidebar, select Tools & MCP.

Click the Add Custom MCP button and configure:
- Name: static-app
- Type: streamableHttp
- URL: https://mcp.static.app/sse
- Headers: Authorization: Bearer YOUR_API_KEY

Using Static.app with Cursor

Open the AI pane (Agent mode) and enter a request:

"Using the Static.app MCP, download my entire website as a ZIP file so I can review the current structure."

Windsurf (Codeium's Agentic IDE)

Windsurf supports MCP servers through its Cascade AI system.

Configuration

Go to Windsurf -> Settings and navigate to the Cascade section.
Under MCP Servers, click on Open MCP Marketplace or the gear icon for settings.
Update your mcp_config.json with the following:

{
  "mcpServers": {
    "static-app": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "[https://mcp.static.app/sse](https://mcp.static.app/sse)",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Note: Restart Windsurf to apply the changes.

Available Tools & Use Cases

The MCP server exposes 12 tools across two main categories:

1. Sites & Files

(Tools: list_sites , get_site , get_site_files , delete_site , create_site_from_archive , update_site_from_archive , download_site_archive , download_site_files , upload_site_files )

"Show me all my static websites."
"Create a new site from the archive at /path/to/site.zip."
"Upload /path/to/index.html to my site with PID '0aw4jtby1z'."
"Download only index.html and style.css from my production site."

2. Forms

(Tools: list_forms , get_form , get_form_entries , delete_form_entry )

"List all forms for site '0aw4jtby1z'."
"Get all submissions from the contact form on my main site."
"Delete form entry 12345 from the lead generation form."

Troubleshooting & Testing

If you run into issues, you can test the MCP endpoint directly with cURL to verify your API key works.

Test SSE Connection

curl -v -H "Authorization: Bearer YOUR_API_KEY" \
  [https://mcp.static.app/sse](https://mcp.static.app/sse)

Common Errors:

401 Unauthorized: Verify your API key is correct and starts with the Bearer prefix in headers.
Site not found: Ensure you are using the PID (e.g., 0aw4jtby1z ) and not the numeric ID.
Connection errors: Verify the URL is exactly https://mcp.static.app/sse and your network allows SSE.

API Reference

The Static.app MCP server implements the MCP specification (2025-03-26) using Server-Sent Events (SSE) transport with JSON-RPC 2.0.