MCP Tools Reference: Android Device Management MCP Server

Tool: list_web_apps

Lists web apps for a given enterprise. Requires the enterprise resource name in the parent field (e.g., enterprises/{enterpriseId}).

The following sample demonstrate how to use curl to invoke the list_web_apps MCP tool.

Curl Request
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_web_apps",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

Input Schema

Request to list web apps for a given enterprise.

ListWebAppsRequest

JSON representation
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Fields
parent

string

The name of the enterprise in the form enterprises/{enterpriseId}.

pageSize

integer

The requested page size. This is a hint and the actual page size in the response may be different.

pageToken

string

A token identifying a page of results returned by the server.

Output Schema

Response to a request to list web apps for a given enterprise.

ListWebAppsResponse

JSON representation
{
  "webApps": [
    {
      object (WebApp)
    }
  ],
  "nextPageToken": string
}
Fields
webApps[]

object (WebApp)

The list of web apps.

nextPageToken

string

If there are more results, a token to retrieve next page of results.

WebApp

JSON representation
{
  "name": string,
  "title": string,
  "startUrl": string,
  "icons": [
    {
      object (WebAppIcon)
    }
  ],
  "displayMode": enum (DisplayMode),
  "versionCode": string
}
Fields
name

string

The name of the web app, which is generated by the server during creation in the form enterprises/{enterpriseId}/webApps/{packageName}.

title

string

The title of the web app as displayed to the user (e.g., amongst a list of other applications, or as a label for an icon).

startUrl

string

The start URL, i.e. the URL that should load when the user opens the application.

icons[]

object (WebAppIcon)

A list of icons for the web app. Must have at least one element.

displayMode

enum (DisplayMode)

The display mode of the web app.

versionCode

string (int64 format)

The current version of the app.

Note that the version can automatically increase during the lifetime of the web app, while Google does internal housekeeping to keep the web app up-to-date.

WebAppIcon

JSON representation
{
  "imageData": string
}
Fields
imageData

string

The actual bytes of the image in a base64url encoded string (c.f. RFC4648, section 5 "Base 64 Encoding with URL and Filename Safe Alphabet").

  • The image type can be png or jpg.
  • The image should ideally be square.
  • The image should ideally have a size of 512x512.

Tool Annotations

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌