@qirabot/mcp

MCP (Model Context Protocol) server for Qirabot — AI-powered device automation for Claude, Cursor, and other MCP clients.

Control mobile and desktop devices with natural language through your AI assistant. The server exposes tools for running automation tasks, taking screenshots, and managing devices.

Installation

npm install -g @qirabot/mcp

Configuration

1. Sign up at qirabot.com and get your API key from the dashboard.
2. Set it as an environment variable:

export QIRA_API_KEY="qk_your_api_key"

Setup

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "qira": {
      "command": "qira-mcp-server",
      "env": {
        "QIRA_API_KEY": "qk_your_api_key"
      }
    }
  }
}

Claude Code

claude mcp add qira -- qira-mcp-server --api-key $QIRA_API_KEY

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "qira": {
      "command": "qira-mcp-server",
      "env": {
        "QIRA_API_KEY": "qk_your_api_key"
      }
    }
  }
}

Remote HTTP Mode

For shared or remote deployments, run the server in HTTP mode:

qira-mcp-server --transport http --port 3100

Clients connect with API key in the header:

{
  "mcpServers": {
    "qira": {
      "url": "https://your-server/mcp",
      "headers": {
        "x-qira-api-key": "qk_your_api_key"
      }
    }
  }
}

Tools

Tool	Description
list_devices	List all active devices with their IDs, OS, type, and resolution
list_model_aliases	List available AI model aliases (e.g. 'balanced', 'high-quality')
run_task	Run an automation task on a device with a natural language instruction
get_task	Get the status and step details of a running or completed task
take_screenshot	Capture a live screenshot of a device's screen
cancel_task	Cancel a pending or running task

Usage Examples

Once configured, you can ask your AI assistant:

• "List my connected devices"
• "Take a screenshot of my phone"
• "Open Chrome on my device and search for 'weather today'"
• "Go to wikipedia.org and extract the featured article title"
• "Open the Settings app and enable dark mode"

CLI Options

qira-mcp-server [options]

Options:
  --server, -s      Server URL (default: https://app.qirabot.com, or QIRA_SERVER_URL env)
  --api-key, -k     API key (required for stdio; or QIRA_API_KEY env)
  --transport, -t   Transport mode: "stdio" (default) or "http"
  --port, -p        HTTP server port (default: 3100)
  --help, -h        Show help

Environment Variables

Variable	Description
QIRA_SERVER_URL	Server URL (default: https://app.qirabot.com)
QIRA_API_KEY	API key (alternative to --api-key)

License

MIT