What port does the Brilliant MCP server use?
How to fix a connection after the port changed
Find the live address
Open Settings (Cmd+, on macOS, Ctrl+, on Windows) and choose MCP connections. The live endpoint is at the bottom of the page.
Default local endpoint
http://127.0.0.1:3333/mcpCheck your tool's row
A checked tool follows Brilliant's port on every start. If the row reads as off after a hand edit, or after a fallback to 3334 or 3335, toggle it on to rewrite the entry.
Restart the tool
Most tools load MCP servers at startup, so the new address takes effect in a new session.
Or set the address by hand
In Claude Code, add the server by its address. Replace 3333 with the port MCP connections shows.
Claude Code
claude mcp add --transport http --scope user brilliant http://127.0.0.1:3333/mcp
Common problems
| Problem | Fix |
|---|---|
| A second copy of Brilliant is running | Each instance gets its own address. The second copy leaves your config entries alone, and its row reads Another Brilliant instance owns this config until you check it there. |
| The connection is refused | Brilliant is closed. The local server runs only while the app is open. |
| The row shows off although Brilliant is in the config | The check means the config points at Brilliant's current address. Toggle it on to rewrite the entry, then restart the tool. |
Questions
Can other machines reach that port?
No. The server listens on 127.0.0.1, which is your own machine only.
Does the npx helper use port 3333?
The helper looks for the desktop app on 127.0.0.1 ports 3333 to 3335 and uses it when it is running. Otherwise it pairs with a brilliant.design tab in your browser.
Do I change the port in my config after a restart?
No, if you connected through Settings, MCP connections. A checked tool follows the port on every start.
Is there an address with no port at all?
Yes. https://brilliant.design/mcp is a hosted MCP server with no install and no account. Each design comes back as a link you open in a browser.
Which address do I paste into a config by hand?
http://127.0.0.1:3333/mcp, or the port MCP connections shows. Claude Code and VS Code also need type set to http beside the url.