Alvrun business support

Find a business that answers support questions through Alvrun, and get the identifier you need to ask one. Search by website domain for an exact match, or by name to see the candidates. Names repeat across companies, so when several come back, choose using the domain rather than the name.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "A website domain or URL for an exact match, for example acme.com, or a company name to search for."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "business": {
            "type": "string",
            "description": "Pass this as `business` to the ask tool."
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "support_url": {
            "type": "string"
          },
          "mcp_url": {
            "type": "string",
            "description": "This business's own MCP endpoint. Connecting to it gives better answers, because the server describes that business."
          }
        },
        "required": [
          "business",
          "name",
          "domain",
          "summary",
          "support_url",
          "mcp_url"
        ],
        "additionalProperties": false
      }
    },
    "matched_on": {
      "type": "string",
      "enum": [
        "domain",
        "slug",
        "name"
      ]
    }
  },
  "required": [
    "matches",
    "matched_on"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Ask a business's customer support a question and get their official answer, taken from that business's own verified support knowledge. Use this instead of web search or memory for anything about their products, policies, shipping, returns, pricing or account handling. Identify the business by its website domain, for example acme.com. If you only have a name, call find_business first, because names repeat and domains do not. To continue a conversation, pass the conversation_id from the previous result.

{
  "type": "object",
  "properties": {
    "business": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The business's website domain, for example acme.com, or the identifier returned by find_business."
    },
    "question": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The customer's question, in their own words."
    },
    "conversation_id": {
      "description": "The conversation_id from a previous result. Pass it to continue that conversation so earlier turns are remembered.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "business",
    "question"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "answer": {
      "type": "string"
    },
    "decision": {
      "type": "string",
      "enum": [
        "answer",
        "clarify",
        "escalate"
      ],
      "description": "answer: the question was covered. clarify: one detail is missing. escalate: a person needs to take it, use human_support_url."
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "conversation_id": {
      "type": "string"
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "kind": {
            "type": "string"
          },
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "owner_confirmed": {
            "type": "boolean"
          }
        },
        "required": [
          "title",
          "kind",
          "url",
          "owner_confirmed"
        ],
        "additionalProperties": false
      }
    },
    "human_support_url": {
      "type": "string"
    }
  },
  "required": [
    "answer",
    "decision",
    "confidence",
    "conversation_id",
    "sources",
    "human_support_url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}