A2E Protocol
Examples

Examples

Sample entity-card.json files for different use cases.

Restaurant (Third-Party MCP)

A restaurant using a booking provider for reservations:

{
  "a2e": "0.1",
  "entity": {
    "domain": "acme-restaurant.com",
    "name": "Acme Restaurant",
    "category": "restaurant",
    "description": "French bistro in Saint-Germain-des-Prés",
    "location": {
      "address": "11 Rue Saint-Benoît",
      "city": "Paris",
      "postal_code": "75006",
      "country": "FR",
      "lat": 48.8541,
      "lng": 2.3337
    }
  },
  "mcps": [
    {
      "endpoint": "https://mcp.booking-provider.com",
      "capabilities": ["reservations", "availability", "menu"],
      "entity_ref": "rest-78432",
      "auth_required": false,
      "priority": 1
    }
  ]
}

Airline (First-Party MCP)

An airline hosting their own MCP:

{
  "a2e": "0.1",
  "entity": {
    "domain": "acme-airlines.com",
    "name": "Acme Airlines",
    "category": "transport",
    "location": {
      "city": "New York",
      "country": "US"
    }
  },
  "mcps": [
    {
      "endpoint": "https://mcp.acme-airlines.com",
      "capabilities": [
        "reservations",
        "availability",
        "check_in",
        "seat_selection",
        "booking_management",
        "loyalty"
      ],
      "auth_required": true
    }
  ]
}

Hotel (First-Party + Third-Party)

A hotel with their own MCP plus an OTA integration:

{
  "a2e": "0.1",
  "entity": {
    "domain": "grand-hotel.com",
    "name": "Grand Hotel",
    "category": "hotel"
  },
  "mcps": [
    {
      "endpoint": "https://mcp.grand-hotel.com",
      "capabilities": ["reservations", "availability", "loyalty", "check_in"],
      "auth_required": true,
      "priority": 1
    },
    {
      "endpoint": "https://mcp.hotel-ota.com",
      "capabilities": ["reservations", "availability", "reviews"],
      "entity_ref": "grand-hotel-123",
      "auth_required": false,
      "priority": 2
    }
  ]
}

E-commerce (Delegated Publishing)

A store hosted on an e-commerce platform with auto-generated A2E file:

{
  "a2e": "0.1",
  "entity": {
    "domain": "myboutique.ecommerce-platform.com",
    "name": "My Boutique",
    "category": "retail",
    "description": "Handmade jewelry and accessories"
  },
  "mcps": [
    {
      "endpoint": "https://mcp.ecommerce-platform.com",
      "capabilities": ["ordering", "availability", "info", "support"],
      "entity_ref": "myboutique"
    }
  ]
}

Beauty Salon (Minimal)

The simplest valid A2E file:

{
  "a2e": "0.1",
  "entity": {
    "domain": "salon-marie.fr",
    "name": "Salon Marie",
    "category": "beauty"
  },
  "mcps": [
    {
      "endpoint": "https://mcp.appointments-provider.com",
      "capabilities": ["reservations", "availability"]
    }
  ]
}

Healthcare (With Contact Info)

A medical practice with full contact details:

{
  "a2e": "0.1",
  "entity": {
    "domain": "drsmith.com",
    "name": "Dr. Smith Family Practice",
    "category": "health",
    "description": "Family medicine and preventive care",
    "location": {
      "address": "123 Medical Center Dr",
      "city": "Boston",
      "postal_code": "02115",
      "country": "US",
      "lat": 42.3467,
      "lng": -71.0972
    },
    "contact": {
      "phone": "+16175551234",
      "email": "appointments@drsmith.com"
    }
  },
  "mcps": [
    {
      "endpoint": "https://mcp.healthcare-provider.com",
      "capabilities": ["reservations", "availability", "prescriptions"],
      "entity_ref": "dr-smith-boston",
      "auth_required": true
    }
  ]
}

Download

All examples are available in the GitHub repository.