Contact Us 1-800-596-4880

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:

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

create_and_manage_api_instances

View, create, modify, and delete API policies in the specified environment.

Manage Policies

manage_api_instance_policy

View API configurations in the specified environment.

View APIs Configuration

View API configurations in the specified environment.

View API Configurations

list_api_instances

Exchange

To…​ Required Permission Associated Tool
  • View, create, and download assets within a business group.

  • Edit asset portal content in an existing asset version.

Exchange Administrator

create_and_manage_assets

View, create, and download assets within a business group.

Exchange Contributor

create_and_manage_assets

Create new assets within a business group’s catalog.

Exchange Creator

create_and_manage_assets

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

list_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

Usage

To…​ Required Permission Associated Tool

View usage reports.

Usage 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.