--- schema_version: "1" id: 2b11134afaa71e460992f2eee71d45cefa16e391c810435c6c586fbc84ee5a9f title: MCP Connector 1.5 Reference collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/mcp-connector/1.5/mcp-connector-reference.md canonical_url: https://docs.mulesoft.com/mcp-connector/1.5/mcp-connector-reference source_site: docs.mulesoft.com content_type: documentation content_hash: c0f60951b429445548db102ec36094f5a51cce8286243b394e7f3b1ccd92228d description: MuleSoft Documentation Site release: "1.5" latest: false --- --- product: MCP Connector version: 1.5 --- # MCP Connector 1.5 Reference > For the full documentation index, see: https://docs.mulesoft.com/llms.txt 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	Required
Name	String	Name for this configuration. Connectors reference the configuration with this name.	Yes
Connection	One of: Streamable Http Client Sse Client (Deprecated)	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	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	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	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 - [MCP Client - Call Tool](#CallTool) - [MCP Client - Get Prompt](#GetPrompt) - [MCP Client - List Prompts](#ListPrompts) - [MCP Client - List Resources](#ListResources) - [MCP Client - List Tools](#ListTools) - [MCP Client - Ping](#Ping) - [MCP Client - Read Resource](#ReadResource) ### Server Configuration element to act as an MCP server. #### Parameters

Name	Type	Description	Required
Name	String	Name for this configuration. Connectors reference the configuration with this name.	Yes
Connection	Sse Server (Deprecated) Streamable Http Server	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	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](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#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	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

## Associated Sources - [MCP Server - On New Session Listener](#OnNewSessionListener) - [MCP Server - Prompt Listener](#PromptListener) - [MCP Server - Resource listener](#ResourceListener) - [MCP Server - Tool Listener](#ToolListener) ## Operations ## MCP Client - 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	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.

### Output

Type	Call Tool Response
Attributes Type	Call Tool Result Attributes

### For Configurations - [Client](#Client) ### 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 `` 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	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.

### Output

Type	Get Prompt Response
Attributes Type	Any

### For Configurations - [Client](#Client) ### 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 `` 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	Repeatable In Memory Iterable Repeatable File Store Iterable non-repeatable-iterable	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	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.

### Output

Type	Array of Prompt Metadata

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	Repeatable In Memory Iterable Repeatable File Store Iterable non-repeatable-iterable	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	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.

### Output

Type	Array of Resource Metadata

### For Configurations - [Client](#Client) ### 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 `` 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	Repeatable In Memory Iterable Repeatable File Store Iterable non-repeatable-iterable	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	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.

### Output

Type	Array of Tool Metadata

Name	Type	Description	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	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.

### Output

Type	Any
Attributes Type	Any

### For Configurations - [Client](#Client) ### Throws - MCP:CONNECTIVITY - MCP:RETRY\_EXHAUSTED ## MCP Client - 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	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.

### Output

Type	Resource Content
Attributes Type	Any

### For Configurations - [Client](#Client) ### 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 `` ### Parameters

Name	Type	Description	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	Redelivery Policy	Defines a policy for processing the redelivery of the same message.
Reconnection Strategy	Reconnect Reconnect Forever	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 - [Server](#Server) ## MCP Server - 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 `` nested component. ### Parameters

Name	Type	Description	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	Redelivery Policy	Defines a policy for processing the redelivery of the same message.
Reconnection Strategy	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.
Prompt Messages	Array of one of: Text Prompt Message Content Image Prompt Message Content Embedded Resource Prompt Message Content Resource Link Prompt Message Content	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	Request Attributes

### For Configurations - [Server](#Server) ## MCP Server - 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	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	Redelivery Policy	Defines a policy for processing the redelivery of the same message.
Reconnection Strategy	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.
Resource Listener Content	One of: Text Resource Blob Resource	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	Request Attributes

### For Configurations - [Server](#Server) ## MCP Server - 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	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	One of: Inline Output Schema File Output Schema	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	Redelivery Policy	Defines a policy for processing the redelivery of the same message.
Reconnection Strategy	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.
Responses	Array of One of: Text Tool Response Content Image Tool Response Content Text Resource Tool Response Content Blob Resource Tool Response Content	Response items when the flow finishes successfully.	Yes
On Error Responses	Array of One of: Text Tool Response Content Image Tool Response Content Text Resource Tool Response Content Blob Resource Tool Response Content	Content items when the flow finishes in error.

### Output

Type	Object
Attributes Type	Request Attributes

### For Configurations - [Server](#Server) ## Types ### TLS Configures TLS to provide secure communications for the Mule app.

Field	Type	Description
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	Truststore	Configures the TLS truststore.
Key Store	Keystore	Configures the TLS keystore.
Revocation Check	Standard Revocation Check Custom OCSP Responder CRL File	Configures a revocation checking mechanism.

### Truststore Configures the truststore for TLS.

Field	Type	Description
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
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
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	Reconnect Reconnect Forever	Reconnection strategy to use.

### Reconnect

Field	Type	Description	Default Value
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	Array of Call Tool Response Content	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	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	Resource Content	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	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	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
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	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	Required
Session Id	String	Yes
Additional Properties	Object	Yes
Client Certificate	Certificate Data

### 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	Array of Certificate Extension
Issuer Alternative Names	Array of Alternative Name Data
Issuer DN	Principal Data
Issuer Unique ID	Array of Boolean
Issuer X500 Principal	X500 Principal Data
Key Usage	Array of Boolean
Name	String
Non Critical Extension OI Ds	Array of String
Not After	Date
Not Before	Date
Public Key	Public Key Data
Serial Number	Number
Serial Number Object	Serial Number Data
Sig Alg Name	String
Sig Alg OID	String
Sig Alg Params	Binary
Signature	Binary
Subject Alternative Names	Array of Alternative Name Data
Subject DN	Principal Data
Subject X500 Principal	X500 Principal Data
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
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	Redelivery Policy 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	Required
Session Id	String		Yes
Request Id	String		Yes
Additional Properties	Object	Additional values attached to the request as HTTP Headers.	Yes
Client Certificate	Certificate Data	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	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
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
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	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	Call Tool 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	Array of Prompt Message Response	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	One of: Text Prompt Response Content Image Prompt Response Content Embedded Resource Prompt Response Content Resource Link Prompt Response Content	The content of the prompt message.		Yes

### Prompt Metadata Prompt metadata returned by `prompts/list`.

Field	Type	Description	Required
Name	String	Prompt name.	Yes
Title	String	Short, human-friendly title.
Description	String	Description of the prompt.
Arguments	Array of Prompt Argument Metadata	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 `` 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	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	Required
Image Data	One of: Inline Image Data File 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	Required
Uri	String	Resource URI.	Yes
Mime Type	String	The resource MIME type.	Yes
Resource Content	One of: Text Embedded Resource Blob Embedded Resource	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	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	Resource Content	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	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.

## See Also - [Using Anypoint Code Builder to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-acb) - [Using Studio to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [MCP Connector Overview](https://docs.mulesoft.com/mcp-connector/1.5/) - [MuleSoft Help Center](https://help.mulesoft.com)