stackblitz-mcp

Read StackBlitz projects
from any AI assistant

An MCP server that gives AI assistants read-only access to file contents and project structure from StackBlitz reproductions. No authentication required.

npm i -g stackblitz-mcp
Get started

Setup

Add stackblitz-mcp to your AI tool of choice. Pick your editor below.

Claude Desktop

Docs

Config file location:

mac: ~/Library/Application Support/Claude/claude_desktop_config.json win: %APPDATA%\Claude\claude_desktop_config.json 
{
  "mcpServers": {
    "stackblitz": {
      "command": "npx",
      "args": ["-y", "stackblitz-mcp"]
    }
  }
}

Claude Code

Docs

Run in your terminal: 

claude mcp add stackblitz -- npx -y stackblitz-mcp

VS Code (Copilot)

Docs

Config file location:

workspace: .vscode/mcp.json 
{
  "servers": {
    "stackblitz": {
      "command": "npx",
      "args": ["-y", "stackblitz-mcp"]
    }
  }
}

Cursor

Docs

Config file location:

project: .cursor/mcp.json global: ~/.cursor/mcp.json 
{
  "mcpServers": {
    "stackblitz": {
      "command": "npx",
      "args": ["-y", "stackblitz-mcp"]
    }
  }
}

Windsurf

Docs

Config file location:

global: ~/.codeium/windsurf/mcp_config.json 
{
  "mcpServers": {
    "stackblitz": {
      "command": "npx",
      "args": ["-y", "stackblitz-mcp"]
    }
  }
}

JetBrains IDEs

Docs

Go to Settings > Tools > AI Assistant > Model Context Protocol (MCP), click Add, and configure a stdio server: 

{
  "command": "npx",
  "args": ["-y", "stackblitz-mcp"]
}

Tools

Four read-only tools for exploring StackBlitz projects. Pass a project URL or ID to any of them.

resolve_project

Resolve a StackBlitz project URL or ID and return project metadata.

Parameter Type Required Description
projectRef string yes Project ID or StackBlitz URL

list_files

List files in a StackBlitz project as an ASCII tree, optionally filtered by path prefix.

Parameter Type Required Description
projectRef string yes Project ID or URL
path string no Filter files by path prefix

read_file

Read the contents of a file from a StackBlitz project.

Parameter Type Required Description
projectRef string yes Project ID or URL
path string yes File path within the project

search_files

Search for content within files of a StackBlitz project.

Parameter Type Required Description
projectRef string yes Project ID or URL
query string yes Search query string
regex boolean no Treat query as regex (default: false)
caseSensitive boolean no Case-sensitive search (default: false)
maxResults number no Maximum results (default: 50)

Resources

MCP resources are accessible via URI patterns. Use them to directly reference project data.

URI Pattern Description
stackblitz://{projectId}/tree File tree of a project
stackblitz://{projectId}/files/{path} Contents of a specific file