Contact Us 1-800-596-4880

MCP Connector 1.5 Reference

Anypoint Connector for MCP (MCP Connector) allows Mule applications to act as both MCP servers and clients. When acting as an MCP client, MuleSoft facilitates the creation of integrations and orchestrations where AI agents are integrated as just another system in the workflow.

Configurations

Client

Configuration element that acts as a client and connects to an MCP server.

Parameters

Name Type Description Default Value Required

Name

String

Name for this configuration. Connectors reference the configuration with this name.

Yes

Connection

One of:

The connection types to provide to this configuration.

Yes

Client Name

String

Name the client uses to identify itself during the protocol initialization phase. This isn’t the same as the name given to this config element (which is later referenced through config-ref parameters). This name doesn’t need to be unique.

Yes

Client Version

String

Version the client uses to identify itself during the protocol initialization phase. This doesn’t need to match the connector or Mule application version.

Yes

Name

String

ID used to reference this configuration.

Yes

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.

Connection Types

SSE Client (Deprecated)

Streamable HTTP transport is recommended.

The SSE (Server-Sent Events) Client connection type enables MCP Connector to establish a persistent, one-way (server-sent) connection to an MCP server using the SSE standard. This type of connection allows the MCP server to push real-time updates and messages to the client without the need for the client to constantly poll for new information.

Parameters
Name Type Description Default Value Required

Request Timeout

Number

Sets the duration to wait for server responses before timing out requests.

30

Request Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time Unit for the requestTimeout parameter

SECONDS

Authentication

HttpRequestAuthentication

Default Request Headers

Object

Defines custom headers to send with every request to the MCP server.

Server Url

String

The base URL for the target MCP server

Yes

Sse Endpoint Path

String

/sse

Reconnection Delay

Number

Specifies how long to wait before reinitializing the SSE connection when it times out or closes.

500

Reconnection Delay Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time Unit for the reconnectionDelay

MILLISECONDS

Tls Context

TLS

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Streamable HTTP Client
Parameters
Name Type Description Default Value Required

Request Timeout

Number

Sets the duration to wait for server responses before timing out requests.

30

Request Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time Unit for the requestTimeout parameter

SECONDS

Authentication

HttpRequestAuthentication

Default Request Headers

Object

Defines custom headers to send with every request to the MCP server.

Server Url

String

The base URL for the target MCP server

Yes

Mcp Endpoint Path

String

/mcp

Tls Context

TLS

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment will fail if the test doesn’t pass after exhausting the associated reconnection strategy

Supported Operations

Server

Configuration element to act as an MCP server.

Parameters

Name Type Description Default Value Required

Name

String

Name for this configuration. Connectors reference the configuration with this name.

Yes

Connection

The connection types to provide to this configuration.

Yes

Server Name

String

Name this server uses to identify itself during the protocol initialization phase. This isn’t the same as the name given to this config element (which is later referenced through config-ref parameters). This name doesn’t need to be unique.

Yes

Server Version

String

Version this server uses to identify itself during the protocol initialization phase. This doesn’t need to match the connector or Mule application version.

Yes

Name

String

ID used to reference this configuration.

Yes

Connection Types

SSE Server (Deprecated)

Streamable HTTP transport is recommended.

Exposes the MCP server using the SSE transport.

Parameters
Name Type Description Default Value Required

Request Timeout

Number

Request timeout

10

Request Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Request Timeout unit

SECONDS

Listener Config

String

Reference to the HTTP Listener config used to expose the SSE and messaging endpoints.

Yes

Sse Endpoint Path

String

The endpoint path clients use to initiate the SSE connection.

/sse

Messages Path

String

The path to send the messaging endpoint request to.

/message

Default Sse Response Headers

Object

Default Message Response Headers

Object

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment will fail if the test doesn’t pass after exhausting the associated reconnection strategy

Streamable HTTP Server

Exposes the MCP server using the Streamable HTTP transport, as defined in Streamable HTTP.

Parameters
Name Type Description Default Value Required

Request Timeout

Number

Request timeout

10

Request Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Request Timeout unit

SECONDS

Listener Config

String

Reference to the http:listener-config used to expose the SSE and messaging endpoints.

Yes

Mcp Endpoint Path

String

The endpoint path clients will use to initiate the SSE connection

/mcp

Response Content Type

Enumeration, one of:

  • JSON

  • SSE

Whether responses should be sent by initiating a SSE stream or returning a single application/json body.

SSE

Default Response Headers

Object

Custom headers to include on all valid responses (not including rejected invalid requests).

Session Idle Timeout

Number

Timeout for idle sessions

5

Session Idle Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit qualifying the sessionIdleTimeout

MINUTES

Sessions Object Store

ObjectStore

An ObjectStore used to store session information. When deploying to multiple replicas, it is recommended to define a specific object store that will be distributed across all of them, either through Hazelcast or OSv2. If not specified, a default transient instance will be created. Persistence must be enabled if running MCP Server listeners in a multi-worker deployment. For CloudHub 2.0, the Clustered option also must be enabled.

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment will fail if the test doesn’t pass after exhausting the associated reconnection strategy

Operations

MCP Client - Call Tool

<mcp:call-tool>

Invokes a tool on a remote MCP server.

Response validation is managed by the underlying SDK; the connector doesn’t perform its own validation.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

Yes

Tool Name

String

Name of the tool to invoke.

Yes

Arguments

Object

The tool’s input arguments.

#[payload]

Extract Structured Content

Boolean

Controls how the payload is exposed when a tool returns structured content. When false, the payload is the full CallToolResponse object (previous behavior). When true, if the MCP response has structured content (for example, a tool with an output schema), the payload is the structured object itself so downstream components can reference fields directly (for example, payload.temperature). If structured content is not present and the response has a single text content that is valid JSON, the text is parsed and used as the payload. In all cases, the attributes.rawMcpResponse property contains the entire MCP response in the same format as before. Any validation or schema errors from the SDK are returned to the user as MCP:SCHEMA_VALIDATION_FAILED errors.

true

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Yes

Additional Properties

Object

#[null]

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Call Tool Response

Attributes Type

Call Tool Result Attributes

For Configurations

Throws

  • MCP:CONNECTIVITY

  • MCP:INTERNAL_ERROR

  • MCP:INVALID_PARAMS

  • MCP:INVALID_REQUEST

  • MCP:JSON_RPC_ERROR

  • MCP:METHOD_NOT_FOUND

  • MCP:PARSE_ERROR

  • MCP:REQUEST_TIMEOUT

  • MCP:RETRY_EXHAUSTED

  • MCP:SCHEMA_VALIDATION_FAILED

  • MCP:SERVER_ERROR

  • MCP:UNAUTHORIZED

MCP Client - Get Prompt

<mcp:get-prompt>

Resolves a prompt by name in the remote MCP server and returns the rendered prompt messages. Use this operation when your Mule application (acting as an MCP client) needs to fetch a prompt that a remote MCP server exposes, optionally passing arguments that the server uses to render the prompt content.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

Yes

Prompt Name

String

Name of the prompt to retrieve from the remote MCP server.

Yes

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Yes

Arguments

Object

Arguments to pass to the prompt. The accepted keys and their types are defined by the remote prompt’s argument schema.

#[null]

Additional Properties

Object

Additional properties to include with the request. Use this field to specify custom key-value pairs that are sent with the MCP connector request. This field is optional and null-safe.

#[null]

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Get Prompt Response

Attributes Type

Any

For Configurations

Throws

  • MCP:CONNECTIVITY

  • MCP:INTERNAL_ERROR

  • MCP:INVALID_PARAMS

  • MCP:INVALID_REQUEST

  • MCP:JSON_RPC_ERROR

  • MCP:METHOD_NOT_FOUND

  • MCP:PARSE_ERROR

  • MCP:REQUEST_TIMEOUT

  • MCP:RETRY_EXHAUSTED

  • MCP:SCHEMA_VALIDATION_FAILED

  • MCP:SERVER_ERROR

  • MCP:UNAUTHORIZED

MCP Client - List Prompts

<mcp:list-prompts>

Lists all prompts available in the remote MCP server. Each entry in the returned array includes metadata such as the prompt name, optional title, description, and the argument definitions the prompt accepts.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

Yes

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Yes

Streaming Strategy

Configures how Mule processes streams. Repeatable streams are the default behavior.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Array of Prompt Metadata

For Configurations

Throws

  • MCP:CONNECTIVITY

  • MCP:INTERNAL_ERROR

  • MCP:INVALID_PARAMS

  • MCP:INVALID_REQUEST

  • MCP:JSON_RPC_ERROR

  • MCP:METHOD_NOT_FOUND

  • MCP:PARSE_ERROR

  • MCP:REQUEST_TIMEOUT

  • MCP:RETRY_EXHAUSTED

  • MCP:SCHEMA_VALIDATION_FAILED

  • MCP:SERVER_ERROR

  • MCP:UNAUTHORIZED

MCP Client - List Resources

<mcp:list-resources>

Lists all the available resources in the remote MCP server.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

Yes

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Yes

Streaming Strategy

Configures how Mule processes streams. Repeatable streams are the default behavior.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Array of Resource Metadata

For Configurations

Throws

  • MCP:CONNECTIVITY

  • MCP:INTERNAL_ERROR

  • MCP:INVALID_PARAMS

  • MCP:INVALID_REQUEST

  • MCP:INVALID_URI

  • MCP:JSON_RPC_ERROR

  • MCP:METHOD_NOT_FOUND

  • MCP:PARSE_ERROR

  • MCP:REQUEST_TIMEOUT

  • MCP:RETRY_EXHAUSTED

  • MCP:SCHEMA_VALIDATION_FAILED

  • MCP:SERVER_ERROR

  • MCP:UNAUTHORIZED

MCP Client - List Tools

<mcp:list-tools>

Lists all the available tools in the remote MCP server.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

Yes

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Yes

Streaming Strategy

Configures how Mule processes streams. Repeatable streams are the default behavior.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Array of Tool Metadata

For Configurations

Throws

  • MCP:CONNECTIVITY

  • MCP:INTERNAL_ERROR

  • MCP:INVALID_PARAMS

  • MCP:INVALID_REQUEST

  • MCP:JSON_RPC_ERROR

  • MCP:METHOD_NOT_FOUND

  • MCP:PARSE_ERROR

  • MCP:REQUEST_TIMEOUT

  • MCP:RETRY_EXHAUSTED

  • MCP:SCHEMA_VALIDATION_FAILED

  • MCP:SERVER_ERROR

  • MCP:UNAUTHORIZED

MCP Client - Ping

<mcp:ping>

Pings the remote server.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

Yes

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Yes

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • MCP:CONNECTIVITY

  • MCP:RETRY_EXHAUSTED

MCP Client - Read Resource

<mcp:read-resource>

Reads a resource referenced by its URI.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

Yes

Uri

String

Yes

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Yes

Additional Properties

Object

#[null]

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Resource Content

Attributes Type

Any

For Configurations

Throws

  • MCP:CONNECTIVITY

  • MCP:INTERNAL_ERROR

  • MCP:INVALID_PARAMS

  • MCP:INVALID_REQUEST

  • MCP:INVALID_URI

  • MCP:JSON_RPC_ERROR

  • MCP:METHOD_NOT_FOUND

  • MCP:PARSE_ERROR

  • MCP:REQUEST_TIMEOUT

  • MCP:RETRY_EXHAUSTED

  • MCP:SCHEMA_VALIDATION_FAILED

  • MCP:SERVER_ERROR

  • MCP:UNAUTHORIZED

Sources

MCP Server - On New Session Listener

<mcp:on-new-session-listener>

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

Yes

Primary Node Only

Boolean

Determines whether to execute this source on only the primary node when running Mule instances in a cluster.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Yes

Redelivery Policy

Defines a policy for processing the redelivery of the same message.

Reconnection Strategy

A retry strategy in case of connectivity errors

Reject With Status Code

Number

Reject With Message

String

Reject With Headers

Object

Output

Type

New Session Request

For Configurations

MCP Server - Prompt Listener

<mcp:prompt-listener>

Exposes a prompt whose messages are generated by the execution of the owning flow. The flow is executed for every received prompts/get request. When triggered, the flow runs with a message whose payload contains the prompt name and the arguments supplied by the client. The messages returned to the client are produced by the <mcp:prompt-messages> nested component.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

Yes

Name

String

The prompt name. This value is what clients use to request the prompt.

Yes

Title

String

A short, human-friendly prompt title.

Description

String

A detailed enough description for an LLM to determine when this prompt should be used.

Prompt Arguments

Array of Prompt Argument

Prompt argument definitions exposed in prompts/list. Each argument can be declared as required or optional and can include a description and a JSON schema that the client uses to validate input.

Primary Node Only

Boolean

Determines whether to execute this source only on the primary node when running Mule instances in a cluster.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Yes

Redelivery Policy

Defines a policy for processing the redelivery of the same message.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Prompt Messages

Defines the prompt messages returned to the client. These parameters are evaluated when the flow finishes successfully (when the payload and variables are available).

Yes

Output

Type

Prompt Request

Attributes Type

For Configurations

MCP Server - Resource listener

<mcp:resource-listener>

Exposes a resource whose content is generated by the execution of the owning flow. The flow is executed for every received resources/read request. The user can choose to implement the flow so that the resource content is static or to make it dynamic. For instance, a dynamic resource could be a expenses.csv file, that is actually the result of executing a live DB query. Or a static resource could be a file obtained through Amazon S3 and locally cached using the ee:cache component.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

Yes

Name

String

Name of the resource.

Yes

Description

String

Detailed enough description for an LLM to determine when to read this resource.

Yes

Uri

String

Resource URI.

Yes

Resource Mime Type

String

Resource MIME type.

Yes

Primary Node Only

Boolean

Determines whether to execute this source on only the primary node when running Mule instances in a cluster.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Yes

Redelivery Policy

Defines a policy for processing the redelivery of the same message.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Resource Listener Content

Defines the resource content and type. These parameters are evaluated when the flow finishes successfully (when the payload and variables available).

Yes

Output

Type

Resource Request

Attributes Type

For Configurations

MCP Server - Tool Listener

<mcp:tool-listener>

Exposes a tool whose result is generated by the execution of the owning flow. The flow will be executed for every received tools/call request. When triggered, the flow will be executed with a message whose payload is a Java map holding the input arguments. The tool response is generated when the flow finishes either successfully or with error. In both cases, the response can include several content items of different types. If no error response is defined, then a text content item holding the error’s description will be generated automatically.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

Yes

Name

String

The tool’s name

Yes

Description

String

A detailed enough description for an LLM to determine when this tool should be called

Yes

Parameters Schema

String

A JSON schema defining an object whose fields will act as the tool’s input arguments

Yes

Output Schema Definition

Optional output schema definition. Choose between inline JSON schema or a file path reference.

Primary Node Only

Boolean

Determines whether to execute this source on only the primary node when running Mule instances in a cluster.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Yes

Redelivery Policy

Defines a policy for processing the redelivery of the same message.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Responses

Response items when the flow finishes successfully.

Yes

On Error Responses

Content items when the flow finishes in error.

Output

Type

Object

Attributes Type

Request Attributes

For Configurations

Types

TLS

Configures TLS to provide secure communications for the Mule app.

Field Type Description Default Value Required

Enabled Protocols

String

Comma-separated list of protocols enabled for this context.

Enabled Cipher Suites

String

Comma-separated list of cipher suites enabled for this context.

Trust Store

Configures the TLS truststore.

Key Store

Configures the TLS keystore.

Revocation Check

Configures a revocation checking mechanism.

Truststore

Configures the truststore for TLS.

Field Type Description Default Value Required

Path

String

Path to the truststore. Mule resolves the path relative to the current classpath and file system.

Password

String

Password used to protect the truststore.

Type

String

Type of store.

Algorithm

String

Encryption algorithm that the truststore uses.

Insecure

Boolean

If true, Mule stops performing certificate validations. Setting this to true can make connections vulnerable to attacks.

Keystore

Configures the keystore for the TLS protocol. The keystore you generate contains a private key and a public certificate.

Field Type Description Default Value Required

Path

String

Path to the keystore. Mule resolves the path relative to the current classpath and file system.

Type

String

Type of store.

Alias

String

Alias of the key to use when the keystore contains multiple private keys. By default, Mule uses the first key in the file.

Key Password

String

Password used to protect the private key.

Password

String

Password used to protect the keystore.

Algorithm

String

Encryption algorithm that the keystore uses.

Standard Revocation Check

Configures standard revocation checks for TLS certificates.

Field Type Description Default Value Required

Only End Entities

Boolean

Which elements to verify in the certificate chain:

  • true

Verify only the last element in the certificate chain.

  • false

Verify all elements in the certificate chain.

Prefer Crls

Boolean

How to check certificate validity:

  • true

Check the Certification Revocation List (CRL) for certificate validity.

  • false

Use the Online Certificate Status Protocol (OCSP) to check certificate validity.

No Fallback

Boolean

Whether to use the secondary method to check certificate validity:

  • true

Use the method that wasn’t specified in the Prefer Crls field (the secondary method) to check certificate validity.

  • false

Don’t use the secondary method to check certificate validity.

Soft Fail

Boolean

What to do if the revocation server can’t be reached or is busy:

  • true

Avoid verification failure.

  • false

Allow the verification to fail.

Custom OCSP Responder

Configures a custom OCSP responder for certification revocation checks.

Field Type Description Default Value Required

Url

String

URL of the OCSP responder.

Cert Alias

String

Alias of the signing certificate for the OCSP response. If specified, the alias must be in the truststore.

CRL File

Specifies the location of the certification revocation list (CRL) file.

Field Type Description Default Value Required

Path

String

Path to the CRL file.

Reconnection

Configures a reconnection strategy for an operation.

Field Type Description Default Value Required

Fails Deployment

Boolean

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Reconnection Strategy

Reconnection strategy to use.

Reconnect

Field Type Description Default Value Required

Frequency

Number

How often in milliseconds to reconnect.

Count

Number

How many reconnection attempts to make.

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

Reconnect Forever

Field Type Description Default Value Required

Frequency

Number

How often in milliseconds to reconnect.

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

Expiration Policy

Configures an expiration policy strategy.

Field Type Description Default Value Required

Max Idle Time

Number

Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for the Max Idle Time field.

Call Tool Response

Response obtained from calling a tool as a client.

Field Type Description Default Value Required

Contents

The contents generated by the tool

Yes

Error

Boolean

Whether the tool execution was successful or errored out. Notice that even in case of error, contents might have been generated.

false

Call Tool Response Content

Field Type Description Default Value Required

Type

Enumeration, one of:

  • text

  • image

  • resource

Content type.

Yes

Text

String

Content’s payload when type is text.

Mime Type

String

Content’s MIME type.

Data

Binary

Content’s payload when type is image.

Resource

Content’s payload when type is resource.

Audience

Array of Enumeration, one of:

  • USER

  • ASSISTANT

Describes who the intended consumer of this data is. It can include multiple entries to indicate content useful for multiple audiences.

Priority

Number

Describes how important this data is for operating the server. A value of 1 means "most important", which indicates that the data is required. A value of 0 means "least important", which indicates that the data is entirely optional.

Resource Content

A flattened representation of a resource content. The resource can be either text or blob types. The text property is set for text resources, while the blob type is used for the latter.

Field Type Description Default Value Required

Uri

String

Resource URI

Yes

Mime Type

String

Resource MIME type.

Yes

Text

String

Content of a text resource. Null for BLOB data types.

Blob

Binary

Content of a BLOB resource. Null for text data types.

Error Mapping

Field Type Description Default Value Required

Source

Enumeration, one of:

  • ANY

  • REDELIVERY_EXHAUSTED

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY

  • SERVER_SECURITY

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED

  • TIMEOUT

Target

String

Yes

Resource Metadata

Field Type Description Default Value Required

Uri

String

Resource URI.

Yes

Name

String

Name of the resource.

Yes

Description

String

Description of the resource.

Yes

Mime Type

String

MIME type of the resource.

Yes

Repeatable In Memory Iterable

Field Type Description Default Value Required

Initial Buffer Size

Number

The amount of memory to allocate to consume the stream and provide random access to it. If the stream contains more data than can fit into this buffer, then the buffer expands according to the Buffer Size Increment value, with an upper limit of the Max In Memory Size value. instances.

100

Buffer Size Increment

Number

Amount by which the buffer size expands if it exceeds its initial size. Setting a value of 0 or lower specifies that the buffer can’t expand.

100

Max Buffer Size

Number

Maximum size of the buffer. If the buffer size exceeds this value, Mule raises a STREAM_MAXIMUM_SIZE_EXCEEDED error. A value of less than or equal to 0 means no limit.

Repeatable File Store Iterable

Field Type Description Default Value Required

In Memory Objects

Number

Maximum number of instances to keep in memory. If more than the maximum is required, content on the disk is buffered.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

Unit for the In Memory Objects field.

Tool Metadata

Describes a tool through its properties.

Field Type Description Default Value Required

Name

String

Name of the tool.

Yes

Description

String

A detailed enough description for an LLM to determine when to call this tool.

Yes

Input Schema

String

JSON Schema describing the tool’s input parameters.

Yes

New Session Request

Contains the data associated to a client requiring the creation of a new server session.

Field Type Description Default Value Required

Session Id

String

Yes

Additional Properties

Object

Yes

Client Certificate

Certificate Data

Field Type Description Default Value Required

Basic Constraints

Number

Critical Extension OI Ds

Array of String

Encoded

Binary

Extended Key Usage

Array of String

Extensions

Issuer Alternative Names

Issuer DN

Issuer Unique ID

Array of Boolean

Issuer X500 Principal

Key Usage

Array of Boolean

Name

String

Non Critical Extension OI Ds

Array of String

Not After

Date

Not Before

Date

Public Key

Serial Number

Number

Serial Number Object

Sig Alg Name

String

Sig Alg OID

String

Sig Alg Params

Binary

Signature

Binary

Subject Alternative Names

Subject DN

Subject X500 Principal

Type

String

Version

Number

Certificate Extension

Field Type Description Default Value Required

Criticality

Boolean

Oid

String

Value

Binary

Alternative Name Data

Field Type Description Default Value Required

Name

String

Type

Number

Principal Data

Field Type Description Default Value Required

Common Name

String

Name

String

X500 Principal Data

Field Type Description Default Value Required

Name

String

Public Key Data

Field Type Description Default Value Required

Algorithm

String

Encoded

Binary

Modulus

Number

Params

Number

Public Key

String

Serial Number Data

Field Type Description Default Value Required

Serial Number

Number

Redelivery Policy

Configures the redelivery policy for executing requests that generate errors. You can add a redelivery policy to any source in a flow.

Field Type Description Default Value Required

Max Redelivery Count

Number

Maximum number of times that a redelivered request can be processed unsuccessfully before returning a REDELIVERY_EXHAUSTED error.

Message Digest Algorithm

String

Secure hashing algorithm to use if the Use Secure Hash field is true. If the payload of the message is a Java object, Mule ignores this value and returns the value that the payload’s hashCode() returned.

Message Identifier

One or more expressions that determine if a message was redelivered. This property can be set only if the Use Secure Hash field is false.

Object Store

ObjectStore

Configures the object store that stores the redelivery counter for each message.

Redelivery Policy Message Identifier

Configures how to identify a redelivered message and how to find out when the message was redelivered.

Field Type Description Default Value Required

Use Secure Hash

Boolean

If true, Mule uses a secure hash algorithm to identify a redelivered message.

Id Expression

String

One or more expressions that determine when a message was redelivered. You can set this property only if the Use Secure Hash field is false.

Resource Request

An inbound request for a resource, used when the connector is acting as an MCP server.

Field Type Description Default Value Required

Requested Uri

String

Yes

Request Attributes

Field Type Description Default Value Required

Session Id

String

Yes

Request Id

String

Yes

Additional Properties

Object

Additional values attached to the request as HTTP Headers.

Yes

Client Certificate

Client certificate used to authenticate the request.

Text Tool Response Content

Defines a text content that’s part of the response of a tool implemented through this connector.

Field Type Description Default Value Required

Text

String

Text content.

Yes

Audience

Array of Enumeration, one of:

  • USER

  • ASSISTANT

Describes who the intended consumer of this data is. It can include multiple entries to indicate content that’s useful for multiple audiences.

Priority

Number

Describes how important this data is for operating the server. A value of 1 means "most important", which indicates that the data is required. A value of 0 means "least important", which indicates that the data is entirely optional.

Image Tool Response Content

Defines an image content that’s part of the response of a tool implemented through this connector.

Field Type Description Default Value Required

Audience

Array of Enumeration, one of:

  • USER

  • ASSISTANT

Describes who the intended consumer of this data is. It can include multiple entries to indicate content useful for multiple audiences.

Priority

Number

Describes how important this data is for operating the server. A value of 1 means "most important", which indicates that the data is required. A value of 0 means "least important", which indicates that the data is entirely optional.

Data

Binary

The raw image content, without Base64 encoding.

Mime Type

String

The image MIME type.

Text Resource Tool Response Content

Defines an embedded text resource that’s part of the response of a tool implemented through this connector.

Field Type Description Default Value Required

Audience

Array of Enumeration, one of:

  • USER

  • ASSISTANT

Describes who the intended consumer of this data is. It can include multiple entries to indicate content useful for multiple audiences.

Priority

Number

Describes how important this data is for operating the server. A value of 1 means "most important", which indicates that the data is required. A value of 0 means "least important", which indicates that the data is entirely optional.

Uri

String

Resource URI.

Mime Type

String

The resource MIME type.

Text

String

Resource text.

Blob Resource Tool Response Content

Defines an embedded blob resource that’s part of the response of a tool implemented through this connector.

Field Type Description Default Value Required

Audience

Array of Enumeration, one of:

  • USER

  • ASSISTANT

Describes who the intended consumer of this data is. It can include multiple entries to indicate content useful for multiple audiences.

Priority

Number

Describes how important this data is for operating the server. A value of 1 means "most important", which indicates that the data is required. A value of 0 means "least important", which indicates that the data is entirely optional.

Blob

Binary

The raw resource content, without Base64 encoding.

Yes

Uri

String

Resource URI.

Mime Type

String

The resource MIME type.

Text Resource

Defines a text resource.

Field Type Description Default Value Required

Text

String

Text content.

Yes

Blob Resource

Defines the contents of a Blob resource.

Field Type Description Default Value Required

Blob

Binary

The raw blob content, without Base64 encoding.

Yes

Custom Header

Configures a custom header to be included in requests or responses.

Name Type Description Default Value Required

Key

String

The header name.

Yes

Value

String

The header value. Supports property placeholders and DataWeave expressions.

Yes

Call Tool Result Attributes

Attributes returned with the CallTool response. Use these attributes to inspect whether the remote tool returned structured content and to access the raw response.

Field Type Description Default Value Required

Structured Content

Boolean

true when the remote tool returned structured content and the payload was set to the structured object (or to JSON parsed from a single text content).

Raw Response

The full tool response returned by the server, including all content items. Useful when Extract Structured Content is true and you still need the original response.

Get Prompt Response

Response returned by prompts/get.

Field Type Description Default Value Required

Description

String

Optional description of the prompt returned by the server.

Messages

The rendered prompt messages.

Yes

Prompt Message Response

A single rendered prompt message.

Field Type Description Default Value Required

Role

String

Role associated with the message (typically user or assistant).

Yes

Content

The content of the prompt message.

Yes

Prompt Metadata

Prompt metadata returned by prompts/list.

Field Type Description Default Value Required

Name

String

Prompt name.

Yes

Title

String

Short, human-friendly title.

Description

String

Description of the prompt.

Arguments

Argument definitions for the prompt.

Prompt Argument Metadata

Description of a single argument supported by a prompt on a remote MCP server.

Field Type Description Default Value Required

Name

String

Argument name.

Yes

Title

String

Short, human-friendly title.

Description

String

Description of the argument.

Required

Boolean

Whether the argument is required.

false

Prompt Request

Input payload for <mcp:prompt-listener> flows.

Field Type Description Default Value Required

Prompt Name

String

The prompt name that was requested.

Yes

Arguments

Object

Map of arguments provided by the client.

Prompt Argument

Prompt argument definition exposed in prompts/list.

Field Type Description Default Value Required

Name

String

Argument name.

Yes

Description

String

Description of the argument.

Required

Boolean

Whether the argument is required.

false

Inline Output Schema

Defines an inline JSON schema for the tool’s output structure. The schema content is provided directly as text.

Field Type Description Default Value Required

Output Schema

String

The JSON schema content.

Yes

File Output Schema

Defines a file-based JSON schema for the tool’s output structure. The schema is loaded from a classpath resource (for example, a file under src/main/resources/ in the Mule project).

Field Type Description Default Value Required

Output Schema File

String

The path to the JSON schema file.

Yes

Text Prompt Message Content

A text-based prompt message content.

Field Type Description Default Value Required

Text

String

The message text. Supports DataWeave expressions.

Yes

Role

Enumeration, one of:

  • USER

  • ASSISTANT

Role associated with the message.

Audience

Array of Enumeration, one of:

  • USER

  • ASSISTANT

Describes who the intended consumer of this data is. It can include multiple entries to indicate content useful for multiple audiences.

Priority

Number

Describes how important this data is for operating the server. A value of 1 means "most important", which indicates that the data is required. A value of 0 means "least important", which indicates that the data is entirely optional.

Image Prompt Message Content

An image-based prompt message content. Image data can be provided inline (via a DataWeave expression) or by selecting a file from the project’s classpath resources. The connector Base64-encodes the data internally.

Field Type Description Default Value Required

Image Data

The image data provided either inline (base64-encoded) or as a file reference.

Yes

Mime Type

String

The image MIME type.

Yes

Role

Enumeration, one of:

  • USER

  • ASSISTANT

Role associated with the message.

Audience

Array of Enumeration, one of:

  • USER

  • ASSISTANT

Describes who the intended consumer of this data is. It can include multiple entries to indicate content useful for multiple audiences.

Priority

Number

Describes how important this data is for operating the server. A value of 1 means "most important", which indicates that the data is required. A value of 0 means "least important", which indicates that the data is entirely optional.

Embedded Resource Prompt Message Content

An embedded resource prompt message content. The resource content (text or blob) is bundled directly inside the prompt message. Choose Text or Blob from the resource content dropdown, matching the same pattern used by the Resource Listener.

Field Type Description Default Value Required

Uri

String

Resource URI.

Yes

Mime Type

String

The resource MIME type.

Yes

Resource Content

The resource content (text or blob).

Yes

Role

Enumeration, one of:

  • USER

  • ASSISTANT

Role associated with the message.

Audience

Array of Enumeration, one of:

  • USER

  • ASSISTANT

Describes who the intended consumer of this data is. It can include multiple entries to indicate content useful for multiple audiences.

Priority

Number

Describes how important this data is for operating the server. A value of 1 means "most important", which indicates that the data is required. A value of 0 means "least important", which indicates that the data is entirely optional.

Resource Link Prompt Message Content

A resource link prompt message content that references an external resource by URI.

Field Type Description Default Value Required

Uri

String

Resource URI.

Yes

Name

String

Name of the linked resource.

Title

String

Human-friendly title.

Description

String

Description.

Mime Type

String

MIME type of the linked resource.

Size

Number

Size of the linked resource.

Role

Enumeration, one of:

  • USER

  • ASSISTANT

Role associated with the message.

Audience

Array of Enumeration, one of:

  • USER

  • ASSISTANT

Describes who the intended consumer of this data is. It can include multiple entries to indicate content useful for multiple audiences.

Priority

Number

Describes how important this data is for operating the server. A value of 1 means "most important", which indicates that the data is required. A value of 0 means "least important", which indicates that the data is entirely optional.

Text Embedded Resource

Text-based embedded resource.

Field Type Description Default Value Required

Text

String

The text content.

Yes

Blob Embedded Resource

Binary embedded resource.

Field Type Description Default Value Required

Blob

Binary

The raw blob content, without Base64 encoding.

Yes

Inline Image Data

Provides image data inline via a DataWeave expression that resolves to binary content. The connector Base64-encodes the data internally before sending it over MCP.

Field Type Description Default Value Required

Image Data

Binary

The image data.

Yes

File Image Data

Provides image data by referencing a file in the project’s classpath resources. The connector reads and Base64-encodes the file content at runtime before sending it over MCP.

Field Type Description Default Value Required

Image File

String

The path to the image file.

Yes

Text Prompt Response Content

Text content in a prompt response.

Field Type Description Default Value Required

Text

String

The text content.

Yes

Image Prompt Response Content

Image content in a prompt response. The data is the raw image bytes (already decoded from Base64).

Field Type Description Default Value Required

Mime Type

String

The image MIME type.

Yes

Data

Binary

The image data.

Yes

Embedded Resource Prompt Response Content

Embedded resource content in a prompt response. The resource content (text or blob) is bundled directly inside the prompt message.

Field Type Description Default Value Required

Resource

The embedded resource payload.

Yes

Resource Link Prompt Response Content

Resource link content in a prompt response. References an external resource by URI.

Field Type Description Default Value Required

Uri

String

Resource URI.

Yes

Name

String

Name of the linked resource.

Title

String

Human-friendly title.

Description

String

Description.

Mime Type

String

MIME type of the linked resource.

Size

Number

Size of the linked resource.