FeaturesAgent CardsOverview

Agent Cards

Create AI agent cards compatible with the A2A (Agent-to-Agent) protocol.

What are Agent Cards?

Agent Cards are JSON specifications that describe AI agents’ capabilities, skills, and how they can be invoked. They follow the A2A (Agent-to-Agent) protocol, enabling agents to discover and interact with each other.

Key Components:

  • Basic Info: Name, description, version
  • Skills: What the agent can do
  • Capabilities: Technical capabilities
  • Invocation: How to call the agent
  • MCP Integration: Link to MCP servers

Creating Agent Cards in MA²D

MA²D makes it easy to design Agent Cards that reference your MCP servers.

Quick Start

  1. Navigate to Agent Cards page
  2. Click “New Agent Card”
  3. Fill in basic information
  4. Define skills and capabilities
  5. Link to MCP servers
  6. Test and publish

Agent Card Structure

{
  "name": "weather-assistant",
  "version": "1.0.0",
  "description": "AI assistant for weather information",
  "skills": [
    {
      "name": "get_weather",
      "description": "Get current weather for cities",
      "mcp_server": "weather-api"
    }
  ],
  "capabilities": {
    "languages": ["en"],
    "domains": ["weather", "meteorology"]
  }
}

Benefits of Agent Cards

  • Discoverability: Other agents can find your agent
  • Interoperability: Standard protocol for agent communication
  • Documentation: Self-describing agent capabilities
  • Marketplace: Publish to Anypoint Exchange

Use Cases

1. Weather Assistant

An agent that provides weather information using MCP tools.

2. Customer Service Agent

An agent that handles customer inquiries with multiple skills.

3. Data Analysis Agent

An agent that analyzes data and generates reports.

A2A Protocol

Agent Cards follow the A2A (Agent-to-Agent) protocol specification:

  • Standard format: JSON-based specification
  • Skill definitions: Clear capability descriptions
  • Invocation patterns: How to call the agent
  • Discovery: Agents can find each other

Integration with MCP Servers

Agent Cards can reference your MCP servers:

{
  "skills": [
    {
      "name": "analyze_sales",
      "mcp_server": "analytics-server",
      "mcp_tool": "analyze_data"
    }
  ]
}

The agent card links to your MCP server, and the MCP server provides the actual implementation.

Publishing to Exchange

Once your Agent Card is ready:

  1. Ensure all fields are complete
  2. Link to published MCP servers
  3. Click “Publish to Exchange”
  4. Configure Exchange settings
  5. Publish!

Your Agent Card will be available in Anypoint Exchange for others to discover.

Best Practices

Clear Descriptions

✅ DO:

{
  "description": "Weather assistant that provides real-time weather data, forecasts, and historical weather information for cities worldwide. Supports temperature, precipitation, wind, and humidity queries."
}

❌ DON’T:

{
  "description": "Weather agent"
}

Well-Defined Skills

Each skill should have:

  • Clear name
  • Detailed description
  • Expected inputs/outputs
  • Use cases

Accurate Capabilities

List capabilities honestly:

  • Supported languages
  • Domain expertise
  • Technical limitations
  • Performance characteristics

Next Steps

Note: Detailed Agent Card documentation is being expanded. The feature is available in MA²D for creating and managing agent specifications.

Learn More:

Creating ServersOverview