Apptics MCP Server

Model Context Protocol (MCP) server for Zoho Apptics analytics. The package authenticates with Zoho, refreshes OAuth tokens on demand, and exposes tools for querying portals, crash lists, crash trends, and active device data from Apptics.

Prerequisites

• Node.js 18 or newer.
• Zoho Apptics OAuth credentials: client ID, client secret, and a refresh token with access to Apptics APIs.

Auth Credentials

To configure Zoho Apptics MCP, you need to provide oauth credentials (client id, client secret and refresh token) as environment variables.

1. Create a new self-client application from Zoho API Console.
2. Generate code with JProxy.jmobileapi.ALL scope.
3. Exchange the code for refresh token using the OAuth token endpoint:

 curl -X POST "https://accounts.zoho.com/oauth/v2/token" \
   -H "Content-Type: application/x-www-form-urlencoded" \
   -d "code=YOUR_SELF_CLIENT_CODE" \
   -d "client_id=YOUR_CLIENT_ID" \
   -d "client_secret=YOUR_CLIENT_SECRET" \
   -d "grant_type=authorization_code"

The JSON response include refresh_token; supply the refresh token via APPTICS_REFRESH_TOKEN. For other Zoho data centers, switch accounts.zoho.com to accounts.zoho.eu, accounts.zoho.in, etc.

Environment Variables

Variable	Required	Description
APPTICS_CLIENT_ID	Yes	OAuth client ID created in the Zoho API Console.
APPTICS_CLIENT_SECRET	Yes	OAuth client secret for the Zoho self-client.
APPTICS_REFRESH_TOKEN	Yes	Refresh token with JProxy.jmobileapi.ALL scope used to obtain access tokens.
APPTICS_SERVER_URI	No	Override for the Apptics API base URL (defaults to https://apptics.zoho.com/). Use regional domains if needed.
APPTICS_ACCOUNTS_URI	No	Override for the Zoho Accounts OAuth base URL (defaults to https://accounts.zoho.com/). Switch to accounts.zoho.eu, etc. for other data centers.

Claude Desktop Configuration

1. Open Claude Desktop.
2. Navigate to Settings -> Developer -> Edit Config
3. Add the following configuration.

   {
     "mcpServers": {
       "zoho-apptics": {
         "command": "npx",
         "args": ["@zoho_apptics/apptics-mcp"],
         "env": {
           "APPTICS_CLIENT_ID": "your_client_id",
           "APPTICS_CLIENT_SECRET": "your_client_secret",
           "APPTICS_REFRESH_TOKEN": "your_refresh_token"
         }
       }
     }
   }

4. Restart Claude Desktop App.

Available Tools

Tool	Description
get_portals_and_projects_list	Lists accessible portals and their projects for the authenticated user.
get_crash_list	Retrieves crash records with optional filters for date range, platform, app version, mode, pagination.
get_crash_count_by_date	Returns aggregated crash statistics keyed by date (hourly when querying a single day).
get_active_devices	Reports active devices grouped by platform/device type/app version within the requested date range.
get_crash_detail	Fetches detailed metadata, stack trace, and context for a specific crash using its uniqueId.
get_device_specific_crash_distribution	Breaks down crash impact by device model for the given crash, with optional pagination and app-version filters.