Skip to main content
Glama
Shopmium MCP Server

Shopmium MCP Server

by Abidil98

Shopmium MCP Server

A custom MCP server that provides high-level tools for controlling Shopmium and Quoty apps on Android emulators.

Installation

# Clone the repository
git clone https://github.com/Abidil98/shopmium-mcp-server.git

# Navigate to the directory
cd shopmium-mcp-server

# Install dependencies
npm install

Related MCP server: DroidMind

Usage

Starting the server

npm start

Adding to Cline MCP settings

Add the following to your Cline MCP settings file:

"github.com/Abidil98/shopmium-mcp-server": {
  "timeout": 60,
  "command": "node",
  "args": [
    "C:/Users/Admin/shopmium-mcp-server/index.js"
  ],
  "transportType": "stdio"
}

Available Tools

select_device

Select an Android device to use.

{
  "device": "emulator-5554"  // Optional, defaults to emulator-5554
}

launch_shopmium

Launch the Shopmium app.

{}

launch_quoty

Launch the Quoty app.

{}

shopmium_navigate_to_tab

Navigate to a specific tab in the Shopmium app.

{
  "tab": "reimburse"  // One of: offers, categories, reimburse, loyaltyCards, purchases
}

shopmium_navigate_to_top_tab

Navigate to a specific top tab in the Shopmium app.

{
  "tab": "home"  // One of: home, shopmiumParty, newItems, laundryCare
}

take_screenshot

Take a screenshot of the current screen.

{}

swipe_screen

Swipe up or down on the screen.

{
  "direction": "up"  // One of: up, down
}

click_at_coordinates

Click at specific coordinates on the screen.

{
  "x": 100,
  "y": 200
}

type_text

Type text into the focused element.

{
  "text": "Hello, world!",
  "submit": true  // Optional, defaults to false
}

terminate_app

Terminate an app.

{
  "app": "shopmium"  // One of: shopmium, quoty
}

Example Usage in Cline

I want to launch Shopmium and navigate to the Reimburse tab.

The LLM will use the custom MCP server to:

  1. Select the device

  2. Launch Shopmium

  3. Navigate to the Reimburse tab

All without having to rediscover package names or UI element coordinates.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that enables AI assistants to control and interact with Android devices, allowing for device management, app debugging, system analysis, and UI automation through natural language commands.
      8
      452
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A FastMCP framework-based server providing Android device automation control capabilities, enabling UI interactions, device management, and application control through natural language.
      20
      MIT