MCP Integration

The VULK MCP Server lets you generate, edit, deploy, and manage VULK projects directly from your AI-powered editor — without opening vulk.dev.

Prerequisites

• A VULK account with an active subscription (Builder plan or higher)
• An API key from vulk.dev/settings/api-keys
• Node.js 18+ installed

Installation

The MCP server runs via npx — no global install required:

npx -y vulk-mcp-server

Configuration

Add the following to your editor's MCP configuration:

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "vulk": {
      "command": "npx",
      "args": ["-y", "vulk-mcp-server"],
      "env": {
        "VULK_API_KEY": "vk_sk_your_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "vulk": {
      "command": "npx",
      "args": ["-y", "vulk-mcp-server"],
      "env": {
        "VULK_API_KEY": "vk_sk_your_key_here"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "vulk": {
      "command": "npx",
      "args": ["-y", "vulk-mcp-server"],
      "env": {
        "VULK_API_KEY": "vk_sk_your_key_here"
      }
    }
  }
}

VS Code

Add to your VS Code settings:

{
  "mcp": {
    "servers": {
      "vulk": {
        "command": "npx",
        "args": ["-y", "vulk-mcp-server"],
        "env": {
          "VULK_API_KEY": "vk_sk_your_key_here"
        }
      }
    }
  }
}

Getting Your API Key

1. Go to vulk.dev/settings/api-keys
2. Click Create API Key
3. Copy the key (it starts with vk_sk_)
4. Add it as VULK_API_KEY in your MCP config

Available Tools

The MCP server provides 6 tools:

Usage Examples

Once configured, you can use natural language in your AI editor:

• "Create a VULK project for a task management app with auth and a dashboard"
• "List my VULK projects"
• "Deploy my latest VULK project"
• "Download the code from my VULK project"

Authentication

Every MCP request is authenticated using your VULK_API_KEY. The key is sent as a Bearer token to the VULK API. Requests without a valid key are rejected with a 401 error.

Rate Limits

MCP requests follow the same rate limits as the VULK API. See API Overview for details.

Troubleshooting

"VULK_API_KEY not set"

Make sure the env block in your MCP config includes VULK_API_KEY with a valid key.

"Unauthorized" errors

Your API key may have expired or been revoked. Create a new one at vulk.dev/settings/api-keys.

MCP server not connecting

Ensure Node.js 18+ is installed and npx is available in your PATH. Try running npx -y vulk-mcp-server in a terminal to verify.

npm Package

The MCP server is published as vulk-mcp-server on npm.