Gemini CLI

Connect ASO++ to Gemini CLI using MCP server configuration.

Gemini CLI is Google's command-line AI agent. It supports MCP servers via a settings.json configuration file.

Prerequisites

Gemini CLI installed — follow the official install guide
An ASO++ API token — generate one here

Configuration

•

Open the Gemini settings file

The configuration file is at ~/.gemini/settings.json. Create it if it doesn't exist:

mkdir -p ~/.gemini && touch ~/.gemini/settings.json

•

Add the ASO++ MCP server

Edit ~/.gemini/settings.json and add:

{
  "mcpServers": {
    "asopp": {
      "httpUrl": "https://asopp.cc/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Replace YOUR_TOKEN_HERE with your actual token.

•

Start a session and verify

Run:

gemini

Then type:

What is the popularity score for the keyword "budget tracker" in the US App Store?

Gemini CLI should call get_keyword_popularity and return the score.

Project-level configuration

To use a different token or configuration per project, create a .gemini/settings.json file inside your project directory. Gemini CLI merges project-level settings with your global settings, with project settings taking priority.

Using environment variables

{
  "mcpServers": {
    "asopp": {
      "httpUrl": "https://asopp.cc/mcp",
      "headers": {
        "Authorization": "Bearer ${ASO_TOKEN}"
      }
    }
  }
}

Set ASO_TOKEN in your shell profile and restart your terminal.

Troubleshooting

Tokens — Generate or revoke tokens
MCP setup overview — Troubleshooting tips and other supported tools

PreviousCodex NextWindsurf