A Model Context Protocol (MCP) server for the Sevalla cloud hosting platform.

Note: This is a community-supported MCP server, not an official Sevalla product. An official MCP server provided and maintained by Sevalla is available at sevalla-hosting/mcp.

Manage your applications, databases, static sites, deployments, pipelines, and more -- all from your AI assistant.

• Node.js v22 or higher
• A Sevalla account with API access
• A Sevalla API key

1. Log in to your Sevalla account
2. Navigate to your API key settings
3. Create or copy your API key

Choose the setup that matches your MCP client:

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sevalla": {
      "command": "npx",
      "args": ["-y", "sevalla-mcp"],
      "env": {
        "SEVALLA_API_KEY": "your-api-key"
      }
    }
  }
}

Add to your Claude Code MCP settings (~/.claude/mcp.json or project-level):

{
  "mcpServers": {
    "sevalla": {
      "command": "npx",
      "args": ["-y", "sevalla-mcp"],
      "env": {
        "SEVALLA_API_KEY": "your-api-key"
      }
    }
  }
}

In Cursor settings, add an MCP server:

{
  "mcpServers": {
    "sevalla": {
      "command": "npx",
      "args": ["-y", "sevalla-mcp"],
      "env": {
        "SEVALLA_API_KEY": "your-api-key"
      }
    }
  }
}

• 118 tools covering the Sevalla API v3
• 8 resources for browsing applications, databases, static sites, pipelines, and users
• 3 prompts for guided deployment, database creation, and API key setup workflows
• Two transport modes: stdio (default) and HTTP with StreamableHTTP
• Security hardened: helmet, rate limiting, CORS, cache control (HTTP mode)
• Session management: LRU-based session cache with idle timeout (HTTP mode)

# Clone the repo
git clone https://github.com/jacob-hartmann/sevalla-mcp.git
cd sevalla-mcp

# Use the Node.js version from .nvmrc
# (macOS/Linux nvm): nvm install && nvm use
# (Windows nvm-windows): nvm install 22 && nvm use 22
nvm install
nvm use

# Install dependencies
pnpm install

# Copy .env.example and configure
cp .env.example .env
# Edit .env with your API key

# Development mode (auto-reload)
pnpm dev

# Production build
pnpm build

# Production run
pnpm start

You can use the MCP Inspector to debug the server:

# Run from source
pnpm inspect

# Run from built output
pnpm inspect:dist

pnpm inspect loads .env automatically via dotenv (see .env.example).

Contributions are welcome! Please see CONTRIBUTING.md for guidelines on how to contribute to this project.

See SECURITY.md for security policy and reporting vulnerabilities.

This is a community project provided "as is" with no guaranteed support. See SUPPORT.md for details.

MIT © Jacob Hartmann