# Sensor Tower through toolfare

> Download and revenue estimates, active users, retention, category totals, top charts, top advertisers and ad creatives from Sensor Tower — answered inside ChatGPT, Claude, Codex or Cursor. Add your own Sensor Tower API token to toolfare once; toolfare charges nothing per read, and each report draws on your Sensor Tower Call Credits.

Page: https://toolfare.ai/sensor-tower

## Use it from your agent

Paste this into Claude Code, Codex, Cursor or any agent with a shell:

> Set up https://toolfare.ai/skill.md, then use toolfare to answer: How many downloads did this competitor’s app get in the US last quarter?

Apps without a terminal connect toolfare as an MCP server: https://toolfare.ai/docs#connect

## Use it from a script

```sh
mkdir -p ~/.local/bin
curl -fsSL 'https://toolfare.ai/toolfare/toolfare.mjs' -o ~/.local/bin/toolfare
chmod +x ~/.local/bin/toolfare
export PATH="$HOME/.local/bin:$PATH"
export TOOLFARE_MCP_URL='https://api.toolfare.ai/mcp'
toolfare login
```

Then connect your Sensor Tower account in the toolfare console (https://toolfare.ai/sensor-tower#setup); calls fail until it is connected.

Sign in once per machine; the CLI renews the sign-in itself. On a CI runner or another server, create an API key in the toolfare console and set it as `TOOLFARE_API_KEY` instead of signing in. Paid calls on one sign-in or key run one at a time. `--max-cost` refuses a call quoted above that many credits (1,000 credits = $3).

## Tools

### Estimates, retention, charts and creatives

Tool: `sensortower_query`

Runs one Sensor Tower report live: download and revenue estimates, active users, retention, category totals, top charts, top advertisers or ad creatives. Revenue is store revenue only, and every figure is Sensor Tower’s estimate.

Ask:
- How many downloads did this competitor’s app get in the US last quarter?
- Which apps are the top advertisers in casual games this month?
- Show me the video creatives this app is running on TikTok.

### How many Call Credits you have left

Tool: `sensortower_usage`

Reads your Sensor Tower Call Credit usage, so a batch of reports does not run you out mid-month.

Ask:
- How many Sensor Tower credits have we used this month?
- Do we have enough Call Credits left for a full category pull?

### The Sensor Tower connections your toolfare account can read

Tool: `sensortower_list_organizations`

Each connected token with its tier and the monthly Call Credit limit seen when it was connected.

Ask:
- Which Sensor Tower account is connected?
- What tier is our Sensor Tower subscription?

## Price

Free to read: it is your own account, so toolfare pays nobody for the data and charges nothing per read. No per-read charge to observe. Reads need no purchase. Like every toolfare call, they run only while your balance holds at least $0.003, and that is not spent.

Balances and top-ups are in US dollars. Quotes and `--max-cost` count credits: 1,000 credits = $3 ($0.003 each).

## Use it when

- You want a competitor app’s downloads, revenue or retention estimates.
- You want the top advertisers or the creatives running in a category.
- You already pay for Sensor Tower and want it answering inside your chat.

## Look elsewhere when

- You want an ad-monetised app’s revenue. Sensor Tower’s revenue estimate covers store purchases only.
- You want app-store keyword rankings and reviews without a Sensor Tower subscription.
- You want your own app’s installs and attribution. That is your attribution account.

## Limits

- Every report spends your own Sensor Tower Call Credits; toolfare charges nothing on top.
- Revenue estimates are store (in-app purchase) revenue in USD cents, and exclude ad monetisation.
- Every figure is a modelled estimate, and the most recent Google Play day is re-estimated later.
- Reports are limited to what your Sensor Tower subscription includes.