API Documentation | MobileAction

Appearance

Connect MobileAction to Gemini CLI ​

You can connect your MobileAction account to Gemini CLI to query app growth data directly from your terminal using natural language. Once configured, Gemini CLI retrieves live keyword rankings, downloads and revenue estimations, reviews, ad creatives, and Apple Ads campaign reports directly from MobileAction.

This guide covers setting up the MobileAction MCP server in Gemini CLI. If you work in Claude or ChatGPT, see the respective guides in our documentation.

Before you begin ​

You will need:

  • An active MobileAction API Solutions plan.
  • Your MobileAction API key. Treat this key like a password.
  • Google Gemini CLI installed on your system.

Step 1: Securely store your API key ​

Avoid hardcoding API keys in your configuration files. Store your MobileAction API key in your environment file.

Create or update ~/.gemini/.env in your home or project directory:

bash
MOBILEACTION_API_KEY=YOUR-API-KEY

Replace YOUR-API-KEY with the key provided by your Customer Success Manager.

Step 2: Configure the MobileAction MCP Server ​

MCP servers in Gemini CLI are configured inside the mcpServers object in your settings file.

Add the configuration to either:

  • Global settings: ~/.gemini/settings.json
  • Project-specific settings: .gemini/settings.json

Add the following remote server configuration:

json
{
  "mcpServers": {
    "mobileaction": {
      "httpUrl": "https://mcp.mobileaction.co/mcp?token=$MOBILEACTION_API_KEY",
      "headers": {
        "Authorization": "Bearer $MOBILEACTION_API_KEY"
      }
    }
  }
}

NOTE

Restart Gemini CLI after updating your settings file for the changes to take effect.

Step 3: Verify the connection ​

Launch Gemini CLI in your terminal and verify that the MobileAction MCP server is connected:

bash
gemini

Inside the CLI session, run:

bash
/mcp list

You should see MobileAction listed as Ready, exposing the available tools and endpoints.

Step 4: Ask your first question ​

Start prompting Gemini CLI directly in plain language:

  • "What are my top 20 keywords for [app name] in the US, and which ones moved this week?"
  • "Pull download estimations for [competitor app] over the last 90 days and compare them with ours."
  • "Summarize the most common complaints in [app name]'s recent App Store reviews."
  • "Which networks is [competitor app] running the most video creatives on?"
  • "Show me an example request for the keyword ranking endpoint."
  • "Build me a weekly visibility summary I can paste into Slack."

NOTE

Gemini CLI automatically selects the required MobileAction tools, fetches live data, and presents the results.

What Gemini CLI can and cannot do ​

The MobileAction MCP server is designed for data retrieval, reporting, and exploration. Gemini CLI reads data from your MobileAction account but does not modify your MobileAction account settings or your Apple Ads campaigns. All strategic and operational decisions remain with you and your team.

Troubleshooting ​

  • Gemini CLI cannot reach MobileAction: Verify that MOBILEACTION_API_KEY is properly set in ~/.gemini/.env and that your settings file uses the full https://mcp.mobileaction.co/mcp?token=$MOBILEACTION_API_KEY URL.
  • Gemini answers from general knowledge instead of MobileAction data: State "Use MobileAction to..." at the start of your prompt to explicitly route the query through the MCP server tools.
  • Credit limits: Requests made through the MCP server consume credits from your standard MobileAction API allowance. You can check remaining credits in your dashboard or ask Gemini CLI directly.

© 2025 MobileAction, Inc.