# Search apps with Embedded MCP

Use the Embedded MCP search-apps tool to find published MindCloud apps and page through catalog results.

`search-apps` finds published MindCloud apps. It searches names, slugs, and aliases. If you omit `q`, it lists the catalog.

| Input | Use |
| --- | --- |
| `q` | Optional app name or slug. |
| `actionQ` | Optional short task, such as `send a message to a channel`. |
| `limit` | Apps per page, 1 to 50. Default 20. |
| `cursor` | `data.nextCursor` from the previous page. |

```json
{
  "q": "slack",
  "actionQ": "send a message to a channel",
  "limit": 20
}
```

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "app_slack",
        "slug": "slack",
        "name": "Slack",
        "actionSlugsPreview": [
          "sendMessage"
        ],
        "actionsTotal": 1,
        "actionsPreviewTruncated": false
      }
    ],
    "limit": 20,
    "nextCursor": null
  }
}
```

`actionSlugsPreview` is a preview. Use [`search-actions`](/docs/embedded/embedded-mcp/tool-calls/search-actions) for the action list. When `actionQ` finds one clear app and action, `suggestedAction` can include the action schema. Search does not grant access to another end user's connections.

If `data.nextCursor` is not `null`, pass it unchanged in the next call. An app missing from this catalog is unavailable to the agent.