Getting Started with MuleSoft MCP Server
MuleSoft MCP Server enables AI-powered development assistants in your IDE to interact with Anypoint Platform, helping you manage APIs, applications, and platform resources directly from your coding environment. Learn how to set up and configure MuleSoft MCP Server for your IDE.
|
If you have Anypoint Code Builder or Connector Builder, MuleSoft MCP Server is already installed and configured in MuleSoft Dev Agent. For more information, see Creating API Specs with MuleSoft Dev Agent and Connector Builder Overview. |
Before You Begin
Before you install and use MuleSoft MCP Server, ensure you have installed the following software:
-
Anypoint Extension Pack version 1.10.0 or later
-
Git
-
Node.js 20 or later. Download Node.js.
You also need permissions or access to perform these tasks:
-
Organization administrator access: create a connected app
-
Agentforce access: run the
generate_mule_flowandgenerate_api_spectools .
Create a Connected App
Follow the steps in Create a Connected App That Acts on Its Own Behalf to create a connected app. Note the Client ID and Client Secret, as you need these to configure MuleSoft MCP Server in your IDE.
Additionally, when prompted, add the following permission scopes. These scope enable you to use specific MuleSoft MCP Server tools. Make sure that all business groups and relevant environments are selected for these scopes.
Refer to the MuleSoft MCP Server Tool Reference for details on all MuleSoft MCP Server tools. Only tools listed in these tables require specific permission scopes.
Anypoint Code Builder
| To… | Required Permission | Associated Tool |
|---|---|---|
Use natural language prompts to develop and generate flows using Agentforce for Anypoint Code Builder Generative Flows. |
Mule Developer Generative AI User |
Anypoint Monitoring
| To… | Required Permission | Associated Tool |
|---|---|---|
View but not modify content in Anypoint Monitoring. |
Monitoring Viewer |
API Manager
| To… | Required Permission | Associated Tool |
|---|---|---|
View and modify API configurations in the specified environment. |
Manage API Configuration |
|
View, create, modify, and delete API policies in the specified environment. |
Manage Policies |
|
View API configurations in the specified environment. |
View APIs Configuration |
|
View API configurations in the specified environment. |
View API Configurations |
Exchange
| To… | Required Permission | Associated Tool |
|---|---|---|
|
Exchange Administrator |
|
View, create, and download assets within a business group. |
Exchange Contributor |
|
Create new assets within a business group’s catalog. |
Exchange Creator |
|
View and download assets within a business group. |
Exchange Viewer |
General
| To… | Required Permission | Associated Tool |
|---|---|---|
View organization information. |
View Organization |
|
View connected applications. |
View Connected Applications |
Runtime Manager
| To… | Required Permission | Associated Tool |
|---|---|---|
View applications in a specific environment. |
Read Applications |
|
Create applications in a specific environment. |
Create Applications |
|
Query Runtime Fabric instances in the organization. |
Read Runtime Fabrics |
|
View CloudHub and CloudHub 2.0 network resources. |
CloudHub Network Viewer |
Install MuleSoft MCP Server
Install MuleSoft MCP Server and then configure it in your IDE by adding the appropriate configuration snippet with your connected app credentials.
To install with Node.js, run: npm install -g @mulesoft/mcp-server.
Configure Your IDE
You can configure Claude Desktop, Cursor, Windsurf, Zed, and other IDEs to work with the MuleSoft MCP Server. After you add the configuration, verify it by checking that the server has started in the MCP section of your IDE.
For more information about Anypoint Platform regions, see Control Plane Hosting Options.
Claude Desktop
Add this snippet to claude_desktop_config.json where ANYPOINT_REGION (optional) is one of these values: PROD_US, PROD_EU, PROD_CA, or PROD_JP.
{
"mcpServers": {
"mulesoft": {
"command": "npx",
"args": ["-y", "@mulesoft/mcp-server", "start"],
"env": {
"ANYPOINT_CLIENT_ID": "<YOUR_CLIENT_ID>",
"ANYPOINT_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
"ANYPOINT_REGION": "<REGION_NAME>"
}
}
}
}
Download Claude Desktop.
Cline
Add this snippet to Cline config.json where ANYPOINT_REGION (optional) is one of these values: PROD_US, PROD_EU, PROD_CA, or PROD_JP.
{
"mcpServers": {
"mulesoft": {
"command": "npx",
"args": ["-y", "@mulesoft/mcp-server", "start"],
"env": {
"ANYPOINT_CLIENT_ID": "<YOUR_CLIENT_ID>",
"ANYPOINT_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
"ANYPOINT_REGION": "<REGION_NAME>"
}
}
}
}
Download Cline.
Cursor
Add this snippet to Cursor mcp.json where ANYPOINT_REGION (optional) is one of these values: PROD_US, PROD_EU, PROD_CA, or PROD_JP.
{
"mcpServers": {
"mulesoft": {
"command": "npx",
"args": ["-y", "@mulesoft/mcp-server", "start"],
"env": {
"ANYPOINT_CLIENT_ID": "<YOUR_CONNECTED_APP_CLIENT_ID>",
"ANYPOINT_CLIENT_SECRET": "<YOUR_CONNECTED_APP_CLIENT_SECRET>",
"ANYPOINT_REGION": "<REGION_NAME>"
}
}
}
}
Download Cursor.
Trae
Add this snippet to Trae mcp_settings.json or .vscode/mcp.json where ANYPOINT_REGION (optional) is one of these values: PROD_US, PROD_EU, PROD_CA, or PROD_JP.
{
"mcpServers": {
"mulesoft": {
"command": "npx",
"args": ["-y", "@mulesoft/mcp-server", "start"],
"env": {
"ANYPOINT_CLIENT_ID": "<YYOUR_CONNECTED_APP_CLIENT_ID>",
"ANYPOINT_CLIENT_SECRET": "<YOUR_CONNECTED_APP_CLIENT_SECRET>",
"ANYPOINT_REGION": "<REGION_NAME>"
}
}
}
}
Download Trae.
VS Code
Add this snippet to VS Code settings.json or .vscode/mcp.json where (optional) ANYPOINT_REGION is one of these values: PROD_US, PROD_EU, PROD_CA, or PROD_JP.
{
"mcp": {
"servers": {
"mulesoft": {
"command": "npx",
"args": ["-y", "@mulesoft/mcp-server", "start"],
"env": {
"ANYPOINT_CLIENT_ID": "<YOUR_CONNECTED_APP_CLIENT_ID>",
"ANYPOINT_CLIENT_SECRET": "<YOUR_CONNECTED_APP_CLIENT_SECRET>",
"ANYPOINT_REGION": "<REGION_NAME>"
}
}
}
}
}
Download VS Code.
Windsurf
Add this snippet to Windsurf mcp_config.json where ANYPOINT_REGION (optional) is one of these values: PROD_US, PROD_EU, PROD_CA, or PROD_JP.
{
"mcpServers": {
"mulesoft": {
"command": "npx",
"args": ["-y", "@mulesoft/mcp-server", "start"],
"env": {
"ANYPOINT_CLIENT_ID": "<YOUR_CONNECTED_APP_CLIENT_ID>",
"ANYPOINT_CLIENT_SECRET": "<YOUR_CONNECTED_APP_CLIENT_SECRET>",
"ANYPOINT_REGION": "<REGION_NAME>"
}
}
}
}
Download Windsurf.
Zed
Add this snippet to Zed settings.json where ANYPOINT_REGION (optional) is one of these values: PROD_US, PROD_EU, PROD_CA, or PROD_JP.
{
"context_servers": {
"mulesoft": {
"command": "npx",
"args": ["-y", "@mulesoft/mcp-server", "start"],
"env": {
"ANYPOINT_CLIENT_ID": "<YOUR_CONNECTED_APP_CLIENT_ID>",
"ANYPOINT_CLIENT_SECRET": "<YOUR_CONNECTED_APP_CLIENT_SECRET>",
"ANYPOINT_REGION": "<REGION_NAME>"
}
}
}
}
Download Zed.



