# Appfigures MCP server

> Lets an AI client query app analytics, store rankings, reviews, keywords, and market intelligence from Appfigures accounts and the app catalog.

- Repository: https://github.com/appfigures/cli
- Page: https://hostedmcp.org/servers/appfigures/cli
- Transport: stdio, remote
- Stars: 21
- License: Apache-2.0
- Latest version: 4.0.0

## Install

### Claude Code

```sh
claude mcp add --env 'APPFIGURES_API_KEY=<YOUR_APPFIGURES_API_KEY>' cli -- npx -y @appfigures/cli
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "@appfigures/cli"
      ],
      "env": {
        "APPFIGURES_API_KEY": "<YOUR_APPFIGURES_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@appfigures/cli"
      ],
      "env": {
        "APPFIGURES_API_KEY": "<YOUR_APPFIGURES_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"cli","type":"stdio","command":"npx","args":["-y","@appfigures/cli"],"env":{"APPFIGURES_API_KEY":"<YOUR_APPFIGURES_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "@appfigures/cli"
      ],
      "env": {
        "APPFIGURES_API_KEY": "<YOUR_APPFIGURES_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add cli --env 'APPFIGURES_API_KEY=<YOUR_APPFIGURES_API_KEY>' -- npx -y @appfigures/cli
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.cli]
command = "npx"
args = ["-y", "@appfigures/cli"]

[mcp_servers.cli.env]
APPFIGURES_API_KEY = "<YOUR_APPFIGURES_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'APPFIGURES_API_KEY=<YOUR_APPFIGURES_API_KEY>' cli npx -- -y @appfigures/cli
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "@appfigures/cli"
      ],
      "env": {
        "APPFIGURES_API_KEY": "<YOUR_APPFIGURES_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `APPFIGURES_API_KEY` | no | yes | Appfigures personal access token. Optional; omit it to sign in with `af auth login` instead. Read more at https://help.appfigures.com/en/article/1chf6wf |

## FAQ

### How do I authenticate to the Appfigures MCP server?

Sign in with your Appfigures account when the MCP client asks, using an OAuth flow. The README notes there is nothing to install and no token to manage for the hosted server.

### What can I query through the Appfigures MCP server?

You can search apps, query metrics datasets, check store ranks and top charts, read reviews, inspect keywords, and view audience demographics and cross-usage.

### Does Appfigures have an API key option for automation?

Yes, for unattended use and headless agents you can set APPFIGURES_API_KEY, created as a personal access token in the developer keys page.

### Is the local `af mcp` stdio server still supported?

It is deprecated and will be removed in the next major release; users should move to the hosted server.
