---
schema_version: "1"
id: 4ebe52dda26dbd7001d24fa024a8222326ef9a9e68ac92b8c60dcdd4ddb77ba8
title: A2A Agent Card Policy
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/gateway/1.12/policies-included-a2a-agent-card.md
canonical_url: https://docs.mulesoft.com/gateway/1.12/policies-included-a2a-agent-card
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 597c9ae3928a036ca96373f8de58b574f8e61e212878e8c9712673f8f17be2ec
description: MuleSoft Documentation Site
release: "1.12"
latest: false
---
---
product: Omni Gateway
version: 1.12
keywords: api gateway, flex gateway, gateway, policy
---

# A2A Agent Card Policy

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

<table><colgroup><col> <col></colgroup><tbody><tr><td><p><strong>Policy Name</strong></p></td><td><p>A2A Agent Card</p></td></tr><tr><td><p><strong>Summary</strong></p></td><td><p>Rewrites the Agent Card URL to match the public URL of the gateway</p></td></tr><tr><td><p><strong>Category</strong></p></td><td><p>A2A</p></td></tr><tr><td><p><strong>First Flex Gateway version available</strong></p></td><td><p>v1.9.3</p></td></tr><tr><td><p><strong>Returned Status Codes</strong></p></td><td></td></tr></tbody></table>

> [!NOTE] This policy supports Agent2Agent Protocol (A2A) version v0.3.0. To learn more about A2A
> versions, see [A2A Releases](https://github.com/a2aproject/A2A/releases).

## Summary

The A2A Agent Card Policy rewrites the URL in the A2A Agent Card responses so that the exposed URL
points to the public endpoint of the Flex Gateway A2A server instance rather than directly to
backend services. This ensures that all client requests are routed through Flex Gateway, enabling it
to enforce security and access controls, while preventing direct access to backend resources.

The A2A Agent Card policy also enables the **Total Agent Calls** metric that tracks the total
successful and unsuccessful calls made to the agent. To view **Total Agent Calls**, see
[Viewing Key Metrics in API Manager for Managed Flex Gateway](https://docs.mulesoft.com/gateway/1.12/flex-managed-view-api-metrics).

## Configuring Policy Parameters

### Flex Gateway Local Mode

The A2A Agent Card policy isn’t supported in Local Mode.

### Managed Flex Gateway and Flex Gateway Connected Mode

When you apply the policy from the UI, the following parameters are displayed:

<table><colgroup><col> <col></colgroup><thead><tr><th>Element</th><th>Description</th></tr></thead><tbody><tr><td><div><div><p>Consumer URL</p></div></div></td><td><div><div><p>The consumer URL of the agent’s A2A service where JSON-RPC requests are sent.<br>If the consumer URL isn’t set, the server instance’s public endpoint is used.</p></div></div></td></tr><tr><td><div><div><p>Card Path</p></div></div></td><td><div><div><p>The path where the agent presents the card.</p></div></div></td></tr></tbody></table>
