# Quickstart

> openaso is an ASO data service built agent-first: keyword ranks, real Apple Search Ads
> popularity, listing audits, reviews, modeled revenue bands, and managed daily rank
> tracking — every capability an MCP tool with a stable JSON contract. One endpoint. One key.

Three steps: key, connect, ask. Your agent handles everything after that — the server
teaches it how App Store search works.

## 0. No key yet? Try it first

Point any MCP client at the keyless trial endpoint and make a real call — no account, no
human in the loop. Every stateless tool, same contracts, 25 calls
a day per network. Tracking, history, webhooks and the App Store Connect tools need an
account; the budget error says so.

```sh
claude mcp add openaso-trial --transport http https://mcp.openaso.ai/trial
```

## 1. Get a key — or just sign in

Create an account at https://openaso.ai/login, then mint an API key in the dashboard at
https://openaso.ai/dashboard. The key is shown **only once** — the dashboard also shows usage and
rotates or revokes keys. Clients that sign in with OAuth (Claude.ai and ChatGPT connectors,
VS Code) can skip the key: add https://mcp.openaso.ai/mcp, approve once in the browser, and the token maps
to the same account. Free while in early access:
500 tool calls per day and 500 tracked keyword × app × storefront combinations.

## 2. Connect your client

Claude Code:

```sh
claude mcp add openaso --transport http https://mcp.openaso.ai/mcp \
  --header "Authorization: Bearer YOUR_KEY"
```

Cursor, Windsurf, or anything MCP — same endpoint, same header:

```json
{
  "mcpServers": {
    "openaso": {
      "type": "http",
      "url": "https://mcp.openaso.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
```

`x-api-key: YOUR_KEY` works too if your client cannot set an Authorization header.
The server is stateless Streamable HTTP — POST only, no session juggling.

## 3. Ask for something real

Good first prompts, in rough order of ambition:

- "Where does Streaks rank for `habit tracker` in the US and UK?" — `find_app` resolves the
  name to a trackId, then one `rank` call.
- "Audit the App Store listing for \<your app\> in the US and propose better metadata" —
  the `audit` tool gathers listing, word pool, and scored keyword candidates in one call,
  then your agent drafts against `coverage`.
- "Track our top 20 keywords daily and tell me when anything drops" — `track_config` +
  the managed daily snapshot run, then `history dropsOnly=true` any morning — or a
  `webhook` so the drops come to you.
- "Read our real keyword field from App Store Connect, tighten it, and ship it" —
  `asc_connect` once with an ASC API key, then `asc_listing` → `coverage` →
  `asc_update_listing`, and `annotate` the change so next week's `history` reads as
  before/after.
- "Did the new listing convert better?" — `asc_analytics_enable` once, then
  `asc_analytics` for the real impressions → page views → downloads funnel per
  storefront and source, set against `history` for the same days.

Before a long run, `account` reports the remaining daily budget and tracked capacity.

There is also a packaged `optimize_metadata` prompt on the server — the full playbook
from audit to tracked verification.

---

More: [tool catalog](https://openaso.ai/tools.md) ·
[agent recipes](https://openaso.ai/recipes.md) ·
[how App Store search matches metadata](https://openaso.ai/docs/concepts.md) ·
[limits & data](https://openaso.ai/docs/limits.md)
