> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-mcp-browser-pool-docs-pr112.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Apps

> List apps, invoke actions, and check deployments and invocations

Use `manage_apps` when an agent needs to run a deployed Kernel app or inspect app deployment state. List apps first when the agent doesn't know the exact app or action name, then invoke the action and poll the invocation result.

## Actions

| Action             | Description                  |
| ------------------ | ---------------------------- |
| `list_apps`        | Discover apps.               |
| `invoke`           | Execute an app action.       |
| `get_deployment`   | Retrieve a deployment by ID. |
| `list_deployments` | Check deployment status.     |
| `get_invocation`   | Check action results.        |

## Recommended flow

1. Call `list_apps` to discover available apps and actions.
2. Call `invoke` with `app_name`, `action_name`, and a JSON-string `payload`.
3. Call `get_invocation` with the returned invocation ID when you need the result later.
4. Use `list_deployments` and `get_deployment` when the agent needs deployment status.

## Parameters

| Parameter       | Description                                                               |
| --------------- | ------------------------------------------------------------------------- |
| `action`        | Operation to perform. Required.                                           |
| `app_name`      | (list\_apps, invoke, list\_deployments) App name filter or target.        |
| `action_name`   | (invoke) Action to execute within the app.                                |
| `payload`       | (invoke) JSON string with action parameters.                              |
| `version`       | (list\_apps, invoke) App version filter. Defaults to `latest` for invoke. |
| `deployment_id` | (get\_deployment) Deployment ID to retrieve.                              |
| `invocation_id` | (get\_invocation) Invocation ID to retrieve.                              |
| `limit`         | (list\_apps, list\_deployments) Max results per page. Must be 1-100.      |
| `offset`        | (list\_apps, list\_deployments) Pagination offset. Must be 0 or greater.  |

## Invoke an app

```json theme={null}
{
  "action": "invoke",
  "app_name": "web-scraper",
  "action_name": "scrape",
  "payload": "{\"url\": \"https://reddit.com\"}"
}
```