home / mcp / blu mcp server

Blu MCP Server

Provides an HTTP-based MCP server to inspect Discord, run JavaScript, inspect stores, and analyze DOM elements.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bluscream-vencord-plugins-blu-mcp": {
      "url": "http://127.0.0.1:8787"
    }
  }
}

You run an HTTP-based MCP server that lets you inspect Discord’s context, execute JavaScript, and explore Flux stores and DOM details from a connected MCP client. This server is designed to work locally, giving you powerful inspection and scripting capabilities within Discord’s runtime.

How to use

Connect your MCP client to the server at the configured address, then use the available tools to inspect Discord stores, run JavaScript in context, discover modules, search variables, and inspect DOM elements. You can execute arbitrary JavaScript, query stores like UserStore or GuildStore, and locate webpack modules by properties. When inspecting elements, you’ll receive comprehensive metadata such as XPath, attributes, computed styles, and information about parent and child nodes.

How to install

Prerequisites: ensure you have a compatible runtime environment for MCP plugins (Node.js is commonly used for development flows and tooling). You will enable the MCP server inside the plugin’s settings in your Discord client integration environment.

Step by step install flow for this MCP server setup: 1. Install or enable the Discord MCP plugin in your environment. 2. Open the plugin settings. 3. Set the port to listen on (default is 8787). 4. Enable the MCP server toggle so it starts serving MCP requests automatically.

Configuration and security

Configuration options control how the MCP server operates locally. The server uses HTTP transport and is accessible at the loopback address by default. Important: because the server can execute JavaScript in Discord’s context, only connect from trusted MCP clients. Do not expose the server to untrusted networks.

Configuration details: - Port: The port the MCP server listens on (default: 8787) - Enabled: Toggle to enable/disable the MCP server - Server URL: http://127.0.0.1:8787 (or your configured port)

Usage notes and tips

The server exposes several MCP tools for interacting with Discord’s runtime. Use them to explore store state, execute code, and inspect UI elements. When you perform element inspection, you’ll get a full set of metadata including XPath, attributes, computed styles, and visibility information. Remember to keep security in mind and only connect trusted clients.

Available tools

evaluate_javascript

Execute JavaScript code in Discord's context.

get_store

Get information about a Discord Flux store.

get_store_method

Call a method on a Discord store.

find_webpack_module

Find a webpack module by properties.

find_variable

Recursively search for a variable name in document.* (case-insensitive).

inspect_element

Inspect a DOM element by CSS selector and return detailed metadata.