GuidesAPI ReferenceRelease Notes
HomeLog InHome
Guides

[Beta] Web SDK MCP for AI-assisted integration

Connect the Web SDK MCP to an AI coding assistant for project-aware Web SDK setup, configuration, and troubleshooting.


Updated May 24, 2026.

Connect the Web SDK MCP to your AI coding assistant while you integrate the Experiences Web SDK. Ask questions in Cursor, Claude Desktop, or VS Code, and the MCP provides answers based on your project and installed SDK version.

Who should use this

Use this MCP server if you are integrating the Experiences Web SDK into a web app, including React, Next.js, Vue, Angular, or vanilla JavaScript projects.

This MCP is for Web SDK setup, widget configuration, SDK options, themes, and event handling.

Versioning

  • Tracking: @wscsports/blaze-web-sdk-mcp tracks @wscsports/blaze-web-sdk at major.minor; patches are independent.
  • Pin: Use ~ so the MCP package matches your installed Web SDK major.minor.
  • Supported Web SDK version: @wscsports/blaze-web-sdk 0.35.2 or later (the earliest release this MCP server supports)
  • After you upgrade the Web SDK: Update the pin (for example, 0.36.x@wscsports/blaze-web-sdk-mcp@~0.36).

AI coding assistant configuration

Add this block to your editor MCP config (use the major.minor from Versioning). See per tool instructions in the section that follows.

{
  "mcpServers": {
    "blaze-web-sdk": {
      "command": "npx",
      "args": ["-y", "@wscsports/blaze-web-sdk-mcp@~0.35"]
    }
  }
}

Per-tool configuration

Add the configuration JSON to .cursor/mcp.json in the project (or ~/.cursor/mcp.json for global setup).

Restart the editor or refresh MCP before you chat.

MCP tools

ToolDescription
analyze_projectScans the project for Web SDK integration issues
get_setup_guideFramework-specific setup steps
get_widget_guideWidget configuration guide and examples
get_config_referenceIBlazeSDKOptions reference
get_theme_referenceTheme object structure per content type
validate_configValidates configuration objects
generate_componentGenerates framework-specific components
get_event_referenceDelegation events documentation

Example prompts

  • "Set up the Web SDK in my React project"
  • "Create a row widget showing story thumbnails"
  • "Why isn't my widget rendering?"
  • "What theme options are available for moments?"
  • "Generate a Next.js component for a video grid"
  • "Validate my SDK configuration"

Related docs



Did this page help you?