A2A Integration

What is A2A?

A2A (Agent-to-Agent) is an open protocol for AI agents to discover and communicate with each other. Created by Google and the Linux Foundation, it provides a standard way for agents to advertise their capabilities and exchange tasks.

LDM as an A2A agent

LDM publishes an Agent Card at the well-known URL. Any A2A-compatible agent can discover LDM's capabilities automatically:

https://api.live-direct-marketing.online/.well-known/agent-card.json

Agent Card

{
  "name": "LDM Delivery Agent",
  "description": "Inbox-verified B2B email delivery. Pay only for delivered.",
  "url": "https://api.live-direct-marketing.online",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": true
  },
  "skills": [
    {
      "id": "send_message",
      "name": "Send Email Message",
      "description": "Send a B2B email with inbox verification and delivery tracking.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "to": { "type": "string", "description": "Recipient email" },
          "subject": { "type": "string", "description": "Email subject" },
          "body": { "type": "string", "description": "Email body" },
          "from_pool": {
            "type": "string",
            "enum": ["managed", "byo"],
            "description": "Sender pool"
          }
        },
        "required": ["to", "subject", "body", "from_pool"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "message_id": { "type": "string" },
          "status": { "type": "string" }
        }
      }
    },
    {
      "id": "check_delivery",
      "name": "Check Delivery Status",
      "description": "Check inbox/spam/bounce status of a sent message.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "message_id": { "type": "string" }
        },
        "required": ["message_id"]
      }
    }
  ],
  "authentication": {
    "schemes": ["bearer"],
    "credentials": "API key from https://ldm.delivery/dashboard"
  }
}

Calling LDM from your agent

Use any A2A client library to send tasks to LDM. Here is an example using the Python A2A client:

from a2a.client import A2AClient

client = A2AClient(
    agent_url="https://api.live-direct-marketing.online",
    auth_token="ldm_live_sk_abc123..."
)

# Discover capabilities
card = client.get_agent_card()
print(card.skills)

# Send a message task
result = client.send_task(
    skill="send_message",
    input={
        "to": "cto@acme.com",
        "subject": "Quick question",
        "body": "Hi, I noticed your team is scaling...",
        "from_pool": "managed"
    }
)

print(result.status)       # "queued"
print(result.message_id)   # "msg_01HQX7kP..."

Registering your agent

If your agent wants to receive replies or delivery notifications via A2A, register its Agent Card URL in your LDM dashboard:

• ●Go to Dashboard → Settings → A2A
• ●Enter your agent's Agent Card URL
• ●LDM will discover your agent's skills and push notifications to it