# exo_search_apps

> Documentation index: https://exomations.com/llms.txt

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

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: `build`.

## Input

| Name | Type | Required | Description |
|---|---|---|---|
| `query` | string | no | Free-text search over app name/id/description. Omit to list popular apps. |
| `appId` | string | no | Return full detail (including operations) for this single app id. |
| `limit` | number | no | Max 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

- Tool result with `isError: true`: `No app found with id "<appId>".`
- JSON-RPC -32001 (HTTP 403): `API key lacks the 'build' permission required for flow authoring tools`

## Example call

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

## Example result

```json
{
  "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
  }
}
```
