A2A Protocol Integration

What is A2A?

The Agent-to-Agent Protocol (A2A) is Google's open standard for agent interoperability. It defines how agents discover each other's capabilities through standardized Agent Cards hosted at /.well-known/agent.json.

Our Agent Card

Fetch our Agent Card to discover Jarvis SDK's capabilities:

GET https://jarvissdk.com/.well-known/agent.json

{
  "name": "Jarvis SDK",
  "description": "Agent-native module marketplace with 108+ trust-scored modules...",
  "url": "https://jarvissdk.com",
  "version": "1.0.0",
  "protocol_version": "0.2.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": true,
    "stateTransitionHistory": false
  },
  "authentication": {
    "schemes": ["apiKey"],
    "credentials": {
      "apiKey": {
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "skills": [
    {
      "id": "module-discovery",
      "name": "Module Discovery",
      "description": "Browse and search 108+ modules with trust scoring"
    },
    {
      "id": "module-execution",
      "name": "Module Execution",
      "description": "Install and execute module actions with telemetry"
    },
    {
      "id": "trust-scoring",
      "name": "Trust Scoring",
      "description": "Query trust scores — error rate, uptime, ratings"
    },
    {
      "id": "billing-usage",
      "name": "Billing & Usage",
      "description": "Track execution usage and manage subscriptions"
    }
    // + per-module skills (dynamically generated)
  ]
}

Discovery Flow

Example: A2A Task

// Send a task via A2A
const response = await fetch('https://jarvissdk.com/api/v1/a2a/task', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'jsk_your_key',
  },
  body: JSON.stringify({
    skill: 'module-execution',
    input: {
      module: 'gmail-auto-responder',
      action: 'draft_reply',
      params: {
        email_id: 'msg_123',
        instructions: 'Politely decline the meeting',
      }
    }
  })
});

const result = await response.json();
// {
//   task_id: "task_abc",
//   status: "completed",
//   output: { draft_id: "d_456", preview: "..." },
//   history: [
//     { state: "submitted", timestamp: "..." },
//     { state: "working", timestamp: "..." },
//     { state: "completed", timestamp: "..." }
//   ]
// }

MCP vs A2A: When to Use Which