Creating Agent Cards

Learn how to create Agent Cards that define your AI agent’s capabilities and enable agent-to-agent collaboration.

What You’ll Build

In this guide, you’ll create a Weather Assistant Agent Card with:

• Basic agent information
• Skills definitions
• Capabilities configuration
• MCP server integration

Time Required: 10 minutes

Step 1: Navigate to Agent Cards

1. Login to MA²D
2. Click “Agent Cards” in the sidebar
3. Click ”+ New Agent Card”

Step 2: Basic Information

Fill in the agent details:

Name:

weather-assistant

Version:

1.0.0

Description:

Intelligent weather assistant providing real-time weather data, forecasts, and weather-related insights for cities worldwide. Supports multiple temperature units and natural language queries.

Author:

Your Organization Name

License:

Apache-2.0

Click “Next” or scroll down.

Step 3: Define Skills

Skills describe what your agent can do. Click ”+ Add Skill”.

Skill 1: Get Weather

Name:

get_weather

Description:

Get current weather conditions including temperature, humidity, wind speed, and weather conditions for any city worldwide

Parameters:

{
  "city": "string - City name",
  "units": "string - celsius or fahrenheit (optional)"
}

Returns:

Weather object with current conditions

MCP Server:

weather-api

(Select from your servers)

MCP Tool:

get_weather

Click “Save Skill”.

Skill 2: Get Forecast (Optional)

Add another skill:

Name: get_forecast Description: “Get 7-day weather forecast with daily conditions” Parameters: {"city": "string", "days": "number (1-7)"} Returns: “Array of daily forecast objects” MCP Server: weather-api MCP Tool: get_forecast

Step 4: Configure Capabilities

Define what your agent supports:

Languages:

• English
• Spanish
• French

Domains:

weather, meteorology, climate

Input Modes:

• Text
• Voice
• Image

Output Modes:

• Text
• JSON
• Speech

Technical Capabilities:

• Streaming
• Async
• Rate Limit: 100 requests/minute

Step 5: Set Invocation Details

Configure how agents call your agent:

Protocol:

MCP

Endpoint:

https://ma2d.vercel.app/api/platform/YOUR_SERVER_ID/mcp

(Auto-filled from linked MCP server)

Authentication:

• Type: Bearer Token (optional)
• Required: No (for public agents)

Method:

POST

Format:

json-rpc

Step 6: Add Examples

Provide sample interactions:

Example 1

Skill:

get_weather

Description:

Get weather for San Francisco

Input:

{
  "city": "San Francisco",
  "units": "fahrenheit"
}

Output:

{
  "city": "San Francisco",
  "temperature": 65,
  "units": "fahrenheit",
  "conditions": "Partly cloudy",
  "humidity": 72,
  "wind_speed": 12
}

Click “Add Example” and save.

Add 2-3 more examples for different scenarios.

Step 7: Review and Save

1. Review all information
2. Click “Create Agent Card”
3. Your Agent Card is now created!

Step 8: Test Integration

Verify the Agent Card links to your MCP server:

1. Click on your Agent Card
2. Go to “Test” tab
3. Select a skill
4. Click “Test Skill”
5. Verify response from MCP server

Step 9: Publish to Exchange

When ready, publish your Agent Card:

1. Ensure linked MCP server is published first
2. Click “Publish to Exchange”
3. Configure Exchange metadata
4. Click “Publish”

Your Agent Card is now discoverable by other agents!

Best Practices

• Clear Descriptions - Be specific about capabilities
• Complete Skills - Document all parameters
• Realistic Examples - Use real-world scenarios
• Link to MCP - Connect to published MCP servers
• Keep Updated - Update when capabilities change

Next Steps

• Agent Cards Concept - Deep dive into A2A
• Agent Card Spec - Complete schema
• Publishing Guide - Share your work

Congratulations! You’ve created your first Agent Card! 🎉