Ada Diamonds Concierge

{
  "name": "Ada Diamonds Concierge",
  "description": "Ada Diamonds concierge agent: searches live lab grown diamond inventory, engagement ring settings, and fine jewelry, answers questions from the diamond buying guides, and explains how to reach a jeweler. Read-only without a credential.",
  "version": "1.0.0",
  "supportedInterfaces": [
    {
      "url": "https://www.adadiamonds.com/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "organization": "Ada Diamonds",
    "url": "https://www.adadiamonds.com"
  },
  "documentationUrl": "https://www.adadiamonds.com/developers",
  "iconUrl": "https://www.adadiamonds.com/logo512.png",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false,
    "stateTransitionHistory": false,
    "extensions": []
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/markdown",
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "search-diamonds",
      "name": "Search loose lab diamonds",
      "description": "Find currently available loose lab grown diamonds by shape, carat, color, clarity, cut, and price. Returns stones with grading report numbers, prices in US dollars, and product URLs.",
      "tags": [
        "diamonds",
        "search",
        "catalog",
        "lab grown",
        "pricing"
      ],
      "examples": [
        "Find a 1.5 carat oval lab diamond under $5,000",
        "What 2 carat round diamonds do you have in F color VS1?"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/markdown",
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "search-engagement-rings",
      "name": "Search engagement ring settings",
      "description": "Find engagement ring settings by center stone shape, style, and setting price. Setting prices exclude the center diamond; pair with search-diamonds to quote a complete ring.",
      "tags": [
        "engagement rings",
        "settings",
        "search",
        "catalog"
      ],
      "examples": [
        "Show me halo settings for an oval center stone",
        "Solitaire engagement ring settings under $3,000"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/markdown",
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "search-jewelry",
      "name": "Search fine jewelry",
      "description": "Find wedding bands, earrings, necklaces, bracelets, and fashion rings set with lab grown diamonds, by type and price.",
      "tags": [
        "jewelry",
        "wedding bands",
        "earrings",
        "necklaces",
        "search"
      ],
      "examples": [
        "Lab diamond tennis bracelets",
        "Eternity wedding bands under $4,000"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/markdown",
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "answer-diamond-questions",
      "name": "Answer lab grown diamond questions",
      "description": "Answer questions about lab grown diamonds from Ada Diamonds' published guides: the 4Cs, CVD versus HPHT growth, certification, shapes, and buying advice. Answers cite the source article.",
      "tags": [
        "education",
        "knowledge base",
        "4cs",
        "cvd",
        "hpht",
        "certification"
      ],
      "examples": [
        "What is the difference between CVD and HPHT diamonds?",
        "Is a lab grown diamond a real diamond?"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/markdown",
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "find-showroom",
      "name": "Find a showroom",
      "description": "Showroom location, hours, and how consultations work. Ada Diamonds serves clients nationwide by video consultation from its New York City flagship.",
      "tags": [
        "showroom",
        "location",
        "hours",
        "appointment",
        "new york"
      ],
      "examples": [
        "Where is the Ada Diamonds showroom?",
        "What are your hours?"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/markdown",
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "request-consultation",
      "name": "Request a jeweler consultation",
      "description": "Explains how to request a consultation with an Ada Diamonds jeweler. Submitting one on a customer's behalf requires the appointments:write OAuth scope, which only the customer can grant; without it this skill returns the direct contact routes.",
      "tags": [
        "consultation",
        "appointment",
        "contact",
        "oauth"
      ],
      "examples": [
        "I want to talk to a jeweler about a custom ring"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/markdown",
        "text/plain",
        "application/json"
      ]
    }
  ],
  "securitySchemes": {
    "bearer": {
      "type": "http",
      "scheme": "bearer",
      "bearerFormat": "JWT",
      "description": "OAuth 2.1 access token or an Ada API key. Optional: every skill works anonymously; a credential raises the rate limit."
    },
    "apiKey": {
      "type": "apiKey",
      "in": "header",
      "name": "X-Ada-Api-Key",
      "description": "Self-serve key from POST https://www.adadiamonds.com/api/v1/keys."
    },
    "oauth2": {
      "type": "oauth2",
      "description": "OAuth 2.1 with PKCE. Metadata: https://www.adadiamonds.com/.well-known/oauth-authorization-server",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://www.adadiamonds.com/oauth/authorize",
          "tokenUrl": "https://www.adadiamonds.com/api/oauth/token",
          "refreshUrl": "https://www.adadiamonds.com/api/oauth/token",
          "scopes": {
            "catalog:read": "Read the public product catalog \u2014 diamonds, engagement rings, and fine jewelry, with prices and specifications.",
            "content:read": "Read published editorial content \u2014 knowledge base articles, buying guides, and showroom information.",
            "profile:read": "Read the signed-in customer's account profile (name, email, saved preferences).",
            "orders:read": "Read the signed-in customer's order history and order status.",
            "cart:write": "Create and modify a shopping cart on the signed-in customer's behalf.",
            "appointments:write": "Request a consultation or showroom appointment on the signed-in customer's behalf."
          }
        },
        "clientCredentials": {
          "tokenUrl": "https://www.adadiamonds.com/api/oauth/token",
          "scopes": {
            "catalog:read": "Read the public product catalog \u2014 diamonds, engagement rings, and fine jewelry, with prices and specifications.",
            "content:read": "Read published editorial content \u2014 knowledge base articles, buying guides, and showroom information."
          }
        }
      }
    }
  },
  "securityRequirements": [],
  "protocolVersion": "0.3.0",
  "url": "https://www.adadiamonds.com/a2a",
  "preferredTransport": "JSONRPC",
  "additionalInterfaces": [
    {
      "url": "https://www.adadiamonds.com/a2a",
      "transport": "JSONRPC"
    }
  ],
  "security": [],
  "supportsAuthenticatedExtendedCard": false
}