MCP tool

    exo_search_apps

    Search the app catalogue, or read one app's operations.

    For tools and AI agents: this page as Markdown · the public OpenAPI file

    Description

    Without appId, it returns the apps that match query, or popular apps when there is no query. With appId, it returns that app's full detail: its operations with their parameters, and how to call one from a flow's app_action step. Apps that run through a step type of their own name it in builtInNodes.

    Permission

    Needs an API key or OAuth connection with the build permission.

    Input

    NameTypeRequiredDescription
    querystringNoFree-text search over app name/id/description. Omit to list popular apps.
    appIdstringNoReturn full detail (including operations) for this single app id.
    limitnumberNoMax results for a search (default 25, max 100).

    Returns

    A search returns count and apps (each with id, name, tier, category, description and hasOperations). One app returns id, name, tier, category, description, baseUrl, authType, authNote, docUrl, operations and appActionHint.

    Errors

    Returned as a normal result with isError: true:

    • No app found with id "<appId>".

    Returned as a JSON-RPC error:

    CodeHTTPMessage
    -32001403API key lacks the 'build' permission required for flow authoring tools

    Messages are shown exactly as the server sends them, in English. A value in angle brackets is filled in at run time.

    Examples

    Example call

    {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/call",
      "params": {
        "name": "exo_search_apps",
        "arguments": {
          "query": "qoyod",
          "limit": 1
        }
      }
    }

    Example result

    {
      "jsonrpc": "2.0",
      "id": 1,
      "result": {
        "content": [
          {
            "type": "text",
            "text": "Found 1 app(s) matching \"qoyod\". Pass appId to one of these to see its operations.\n{ ... }"
          }
        ],
        "structuredContent": {
          "count": 1,
          "apps": [
            {
              "id": "qoyod",
              "name": "Qoyod",
              "tier": "native",
              "category": "finance",
              "description": "Saudi cloud accounting (ZATCA e-invoicing). ...",
              "hasOperations": true
            }
          ]
        },
        "isError": false
      }
    }

    Example values. In content, the text after the summary line is the same data as structuredContent.