Appfigures MCP server

@appfigures/cli

The Appfigures CLI — query app metrics, reviews, and store data from your terminal.

Try it now without installing:

npx @appfigures/cli auth login
npx @appfigures/cli apps search "youtube"

Install

npm install -g @appfigures/cli

Requires Node.js 22+. Works with pnpm and yarn too.

Quick start

appfigures auth login
appfigures --help

Also available as af alias.

Authentication

• Log in yourself. af auth login --interactive opens your browser in a guided flow; approve and paste the code back.
• Or let your agent guide you. By default, af auth login prints an authorization URL — open it, approve, and finish with af auth login --code using the code shown. An agent can drive this end to end. For unattended use, set APPFIGURESAPIKEY instead: create a token at appfigures.com/developers/keys by clicking Create a New Client, then Create Personal Access Token.

Either login saves the token to your OS credential manager (macOS Keychain, Windows Credential Manager, Linux Secret Service). See Environment for APPFIGURESAPIKEY and other overrides.

MCP server

af mcp runs a local Model Context Protocol server over stdio, exposing the CLI's app-intelligence commands as MCP tools. Point any MCP client (Claude Code, Claude Desktop, Cursor, and others) at it to let an agent query app metrics, reviews, and store data directly.

Add it to your client's MCP config:

{
	"mcpServers": {
		"appfigures": {
			"command": "npx",
			"args": ["-y", "@appfigures/cli", "mcp"]
		}
	}
}

The server signs in with your stored credentials, so run af auth login once first. For a headless setup, pass a token through the client's env instead:

{
	"mcpServers": {
		"appfigures": {
			"command": "npx",
			"args": ["-y", "@appfigures/cli", "mcp"],
			"env": { "APPFIGURES_API_KEY": "<your-token>" }
		}
	}
}

Installed the CLI globally instead of running it through npx? Use "command": "af" with "args": ["mcp"].

Claude Code. Add it with one command:

claude mcp add appfigures -- npx -y @appfigures/cli mcp

Run af auth login first to sign in, or append --env APPFIGURESAPIKEY= for a headless setup.

<!-- prettier-ignore-start --> <!-- BEGIN auto-generated COMMANDS -->

Commands

Apps

Find apps and look up their identity. Other commands take the app IDs these return.

Explorer

Shortened. The full README is on GitHub.