A2A Connector 0.1.0-BETA Reference | MuleSoft Documentation
# A2A Connector 0.1.0-BETA Reference
Anypoint Connector for Agent2Agent (A2A) (A2A Connector) provides A2A protocol support for LLM agents, enabling your agents to talk to other agents.
Anypoint Connector for Agent2Agent (A2A) is a beta connector that is subject to the Beta Services Terms at Agreements - Salesforce.com or a written Unified Pilot Agreement if executed by Customer, and the Non-GA Gen AI and Non-GA Credit Consumption terms in the Product Terms Directory. Use of this beta connector with external systems or services consumes Mule messages and is at the Customer’s sole discretion.  
---  
## Configurations
### Client
The application or AI system that initiates requests and consumes services offered by A2A servers. This allows Mule apps to act as A2A brokers between non A2A “head” agents and A2A “node” agents.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Name for this configuration. Connectors reference the configuration with this name.  
Connection |  Client Connection | The connection types to provide to this configuration.  
ID used to reference this configuration.  
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
##### Client Connection
###### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Server Url | Base URL of the target A2A server.  
Request Timeout | Sets the duration to wait for server responses before timing out requests.  
Request Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit for the **Request Timeout** field.  
Authentication |  HttpRequestAuthentication  
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.  
### Server
The A2A server acts as a remote agent that exposes an HTTP(S) endpoint and implements the A2A protocol methods for interacting with other AI agents. This allows Mule-based agents to receive and respond to A2A protocol-compliant requests.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Name for this configuration. Connectors reference the configuration with this name.  
Connection | The connection types to provide to this configuration.  
ID used to reference this configuration.  
Task History Enabled | Set to `true` to enable retrieval of task history. Task history is stored as message objects.  
Default Max History Length | Maximum number of task history objects to store.  
Task History Object Store |  ObjectStore  
#### Connection Types
##### Server Connection
###### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Listener Config | Reference to the `<http:listener-config>` used to expose the inbound endpoint.  
Agent Path | URL where the Agent Card is located.  
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.  
#### Associated Sources
  * 

## Supported Operations
  *   * 

## Cancel Task
`<a2a:cancel-task>`
Cancels the task specified by its unique identifier. It’s used to stop a previously initiated task.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Unique identifier for the task. | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | 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 Forever

| Retry strategy in case of connectivity errors.  
### Output
Attributes Type |  Response Attributes  
---|---  
### For Configurations
### Throws
  * A2A:CONNECTIVITY
  * A2A:INTERNAL_ERROR
  * A2A:INVALID_PARAMS
  * A2A:INVALID_REQUEST
  * A2A:JSON_RPC_ERROR
  * A2A:METHOD_NOT_FOUND
  * A2A:PARSE_ERROR
  * A2A:REQUEST_TIMEOUT
  * A2A:RETRY_EXHAUSTED
  * A2A:SERVER_ERROR
  * A2A:UNAUTHORIZED


## Get Task
`<a2a:get-task>`
Retrieves information about a task based on a provided query. This enables you to fetch the status or details of a task from another agent.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Task Query | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | 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 Forever

| Retry strategy in case of connectivity errors.  
### Output
Attributes Type |  Response Attributes  
---|---  
### For Configurations
### Throws
  * A2A:CONNECTIVITY
  * A2A:INTERNAL_ERROR
  * A2A:INVALID_PARAMS
  * A2A:INVALID_REQUEST
  * A2A:JSON_RPC_ERROR
  * A2A:METHOD_NOT_FOUND
  * A2A:PARSE_ERROR
  * A2A:REQUEST_TIMEOUT
  * A2A:RETRY_EXHAUSTED
  * A2A:SERVER_ERROR
  * A2A:UNAUTHORIZED


## Send Task
`<a2a:send-task>`
Sends a task to another agent. It initiates a new task request to a remote A2A server.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
#[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | 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 Forever

| Retry strategy in case of connectivity errors.  
### Output
Attributes Type |  Response Attributes  
---|---  
### For Configurations
### Throws
  * A2A:CONNECTIVITY
  * A2A:INTERNAL_ERROR
  * A2A:INVALID_PARAMS
  * A2A:INVALID_REQUEST
  * A2A:JSON_RPC_ERROR
  * A2A:METHOD_NOT_FOUND
  * A2A:PARSE_ERROR
  * A2A:REQUEST_TIMEOUT
  * A2A:RETRY_EXHAUSTED
  * A2A:SERVER_ERROR
  * A2A:UNAUTHORIZED


## Task Listener
`<a2a:task-listener>`
Allows a Mule application to listen for and receive incoming A2A protocol-compliant requests from other AI agents, enabling the Mule-based agent to act as an A2A server and respond to tasks.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Primary Node Only | 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.  
Redelivery Policy |  Redelivery Policy | Defines a policy for processing the redelivery of the same message.  
Reconnection Strategy | 
  *   * Reconnect Forever

| Retry strategy in case of connectivity errors.  
Response | #[payload]  
Response Headers | HTTP response header.  
Error Status Code | HTTP status code of the response.  
### Output
Attributes Type |  Request Attributes  
---|---  
### For Configurations
## Types
Configures TLS to provide secure communications for the Mule app.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Enabled Protocols** |  Comma-separated list of protocols enabled for this context.  
**Enabled Cipher Suites** |  Comma-separated list of cipher suites enabled for this context.  
**Trust Store** |  Configures the TLS truststore.  
Configures the TLS keystore.  
**Revocation Check** | 
  * Standard Revocation Check
  * Custom OCSP Responder
| Retry strategy in case of connectivity errors.  
Response | #[payload]  
Response Headers | HTTP response header.  
Error Status Code | HTTP status code of the response.  
### Output
Attributes Type |  Request Attributes  
---|---  
### For Configurations
## Types
Configures TLS to provide secure communications for the Mule app.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Enabled Protocols** |  Comma-separated list of protocols enabled for this context.  
**Enabled Cipher Suites** |  Comma-separated list of cipher suites enabled for this context.  
**Trust Store** |  Configures the TLS truststore.  
Configures the TLS keystore.  
**Revocation Check** | 
  * Standard Revocation Check
  * Custom OCSP Responder

|  Configures a revocation checking mechanism.  
### Truststore
Configures the truststore for TLS.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Path to the truststore. Mule resolves the path relative to the current classpath and file system.  
Password used to protect the truststore.  
Type of store.  
Encryption algorithm that the truststore uses.  
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 to the keystore. Mule resolves the path relative to the current classpath and file system.  
Type of store.  
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** |  Password used to protect the private key.  
Password used to protect the keystore.  
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** |  Which elements to verify in the certificate chain: Verify only the last element in the certificate chain. Verify all elements in the certificate chain.  
**Prefer Crls** |  How to check certificate validity: Check the Certification Revocation List (CRL) for certificate validity. Use the Online Certificate Status Protocol (OCSP) to check certificate validity.  
**No Fallback** |  Whether to use the secondary method to check certificate validity: Use the method that wasn’t specified in the **Prefer Crls** field (the secondary method) to check certificate validity. Don’t use the secondary method to check certificate validity.  
What to do if the revocation server can’t be reached or is busy: Avoid verification failure. Allow the verification to fail.  
### Custom OCSP Responder
Configures a custom OCSP responder for certification revocation checks.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
URL of the OCSP responder.  
**Cert Alias** |  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 to the CRL file.  
### Reconnection
Configures a reconnection strategy for an operation.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Fails Deployment** |  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 Forever

|  Reconnection strategy to use.  
### Reconnect
Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
How often to attempt to reconnect, in milliseconds.  
If `false`, the reconnection strategy runs in a separate, non-blocking thread.  
How many reconnection attempts the Mule app can make.  
### Reconnect Forever
Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
How often to attempt to reconnect, in milliseconds.  
If `false`, the reconnection strategy runs in a separate, non-blocking thread.  
### Expiration Policy
Configures an expiration policy strategy.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Max Idle Time** |  Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Max Idle Time** field.  
### Response Attributes
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Status Code** |  HTTP status code of the response.  
Map of HTTP headers in the message.  
**Reason Phrase** |  HTTP reason phrase of the response.  
### Error Mapping
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Enumeration, one of:
  * REDELIVERY_EXHAUSTED
  * TRANSFORMATION
  * EXPRESSION
  * SECURITY
  * CLIENT_SECURITY
  * SERVER_SECURITY
  * ROUTING
  * CONNECTIVITY
  * RETRY_EXHAUSTED
  * TIMEOUT
|  Time unit for the **Max Idle Time** field.  
### Response Attributes
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Status Code** |  HTTP status code of the response.  
Map of HTTP headers in the message.  
**Reason Phrase** |  HTTP reason phrase of the response.  
### Error Mapping
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Enumeration, one of:
  * REDELIVERY_EXHAUSTED
  * TRANSFORMATION
  * EXPRESSION
  * SECURITY
  * CLIENT_SECURITY
  * SERVER_SECURITY
  * ROUTING
  * CONNECTIVITY
  * RETRY_EXHAUSTED
  * TIMEOUT

  
### Agent Card
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Name for the agent.  
Base URL endpoint for the agent’s A2A service. Must be an absolute HTTPS URL for production.  
Version for the agent.  
**Description** |  Description for the agent.  
Array of Agent Skill  
**Capabilities** |  Agent Capabilities  
Agent Provider  
**Documentation Url** |  URL of the agent’s documentation.  
**Agent Authentication** |  Agent Authentication  
**Default Input Modes** |  Array of String |  Array of MIME types the agent accepts as input across all skills.  
**Default Output Modes** |  Array of String |  Array of MIME types the agent produces as output across all skills.  
### Agent Skill
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Unique identifier for this skill within the context of this agent.  
Name of the skill.  
**Description** |  Description of what the skill does.  
Array of String |  Keywords or categories for discoverability of the agent.  
Array of String |  Example prompts, inputs, or use cases. Examples help clients and agents formulate requests for this skill.  
**Input Modes** |  Array of String |  Overrides Agent Card **Default Input Modes** for this specific skill.  
**Output Modes** |  Array of String |  Overrides Agent Card **Default Output Modes** for this specific skill.  
### Agent Capabilities
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Set to `true` to support SSE streaming methods.  
**Push Notifications** |  Set to `true` to support push notification methods.  
**State Transition History**  
### Agent Provider
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Organization** |  Name of the organization or entity.  
URL of the provider’s website.  
### Agent Authentication
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Authentication** |  Array of String  
**Credentials**  
### Request Attributes
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Query Params**  
Map of HTTP headers in the message.  
### 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** |  Maximum number of times to process a redelivered request unsuccessfully before returning a REDELIVERY_EXHAUSTED error.  
**Message Digest Algorithm** |  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** |  If `true`, Mule uses a secure hash algorithm to identify a redelivered message.  
**Id Expression** |  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`.  
## See Also
  * Using Anypoint Code Builder to Configure a Connector
  * Using Studio to Configure a Connector
  * A2A Connector Overview
  * MuleSoft Help Center