MCP for agents

get_overview Overview

Start here. Lists every tracked project (id, store, kind, markets, keyword and top-10 counts, searches checked vs never checked, audit step, last check), folders, running and recently finished jobs, key settings, license state and unread rank alerts. Use the ids it returns with every other tool.

get_project_board Project keyword board

Keyword x market grid for one project, summarised per market: for each keyword its id, label, row summary and, per shown market, rank / previous rank, ESTIMATED volume & difficulty (estVol/estDiff), REAL popularity (pop, only when a provider is connected), verdict and opportunity. Also the top competitors. With more than 4 tracked markets only the main market is shown unless you pass markets. Hidden keywords are excluded unless section is hidden/all.

get_term_detail Keyword detail in one market

Everything about one keyword in one market: the current cell (rank, estimates, real popularity, verdict), rank/estimate history by day, and the apps currently ranking for it (position, rating count, installs, whether the phrase matches their title/subtitle).

list_markets Markets

Markets (countries) available for a store with search language, listing locales and a 0-10 potential score. Use the country codes as market ids.

list_rank_alerts Rank alerts

Rank-change alerts raised by checks (keyword, market, from -> to rank), newest first.

search_store Search the store

Live store search in one market (max 10 apps). Accepts a search term or a pasted store URL. Apps already tracked carry trackedAs {projectId, kind}. Use it to find app ids before add_app.

list_console_apps Developer console apps

Connected developer console accounts for a store (App Store Connect / Google Play Console) and the apps they can see, with whether each app is already tracked.

add_app Track an app

Start tracking an app as a project: your own app (kind mine) or a competitor. Accepts an App Store / Play id, bundle / package name or store URL (find it with search_store). Imports the live listing and seeds keywords in the background; the new project appears in get_overview when the job finishes.

add_console_apps Track all console apps

Track every app visible in the connected developer console account(s) for a store as 'mine' projects (skips ones already tracked).

brainstorm_project Brainstorm a new app idea

Create a brainstorm project for an app that does not exist yet: the AI proposes keywords from a short brief and checks them in the chosen markets. Requires a ready AI provider.

update_project Edit project

Rename a project, change its brief (context used by the AI) or its automatic rank-check schedule.

set_project_markets Set tracked markets

Replace the list of markets (countries) tracked for a project. New markets are empty until run_rank_check runs for them.

move_project Move project

Move a project into a folder (null = top level), optionally placing it before another project.

resync_project Refresh app metadata

Re-import the app's live listing / metadata from the store (and console when connected).

remove_project Delete project

Permanently delete a project with its keywords, rank history and optimizer drafts. Only when the owner asked for this exact project: pass its name (from get_overview) as confirmName; a mismatch deletes nothing.

save_folder Create or rename folder

Create a folder (omit folderId) or rename an existing one.

remove_folder Delete folder

Delete a folder. Its projects are kept and move to the top level.

add_keywords Add keywords

Add one or more keywords (search phrases) to a project. section 'listing' = phrases the listing targets now; 'idea' = candidates to evaluate (default). localize=true asks the AI to translate each phrase into every tracked market's search language (otherwise the same phrase is used everywhere). New keywords have no ranks until run_rank_check.

suggest_keywords AI keyword suggestions

Ask the AI for new keyword ideas for a project based on its listing, brief and current board; they land in the 'idea' section.

localize_keyword Localize keyword

Have the AI translate a keyword into the search language of each market (or the given markets), replacing non-overridden per-market phrases.

set_market_phrase Set phrase for one market

Override the exact search phrase used for a keyword in one market (e.g. a better local wording). An empty phrase removes the override.

edit_keyword Edit keyword

Rename a keyword and/or hide it (hidden keywords stay tracked but leave the active board) or unhide it.

remove_keywords Delete keywords

Permanently delete keywords and their rank history. Prefer edit_keyword hidden:true unless the owner wants them gone.

run_rank_check Check ranks

Search the store for every keyword in the project's markets and record ranks, estimated volume/difficulty and competitors. Runs as a background job (the store is rate-limited, so large boards take minutes). Results already checked today are reused unless force is true.

fetch_popularity Fetch real popularity

Pull REAL search popularity for the project's keywords from the connected source (Apple Ads popularity or Google Ads Keyword Planner). Separate from rank checks and from ASOMaster's estimates; requires a connected source (get_popularity_status).

get_popularity_status Popularity sources

Which REAL popularity sources (Apple Ads, Google Ads Keyword Planner, imported files) are connected, for which store, and when they last fetched. Credentials are never returned.

No parameters.

acknowledge_alerts Mark alerts read / clear

Mark rank alerts as read (given ids, or all when ids is omitted). With clear:true, delete all alerts instead.

get_optimizer Optimizer state

Listing optimizer state for a project: step, current live listing, generated listing options (with reach/difficulty, covered phrases and validation problems), the chosen option, core phrases and per-locale drafts with translation candidates. Descriptions are cut unless full is true.

optimizer_start Generate listing options

Start the listing optimizer for a project: scouts the board's keywords in the main locale and has the AI write several complete listing options (title, subtitle/short description, keyword field, description) scored for reach and difficulty. Replaces previous options. Background job; then read get_optimizer.

optimizer_more_options More listing options

Generate additional listing options next to the existing ones.

optimizer_save_option Add or edit a listing option

Add your own listing option (omit optionId) or replace the listing of an existing option. The app re-scores it and reports validation problems (length limits, repeated words) in get_optimizer.

optimizer_remove_option Remove listing option

Delete one listing option (generated or custom) from the optimizer.

optimizer_choose Choose listing option

Pick the listing option to ship and the core phrases it must carry into every locale. Next step: optimizer_localize.

optimizer_localize Localize chosen listing

Write per-locale drafts of the chosen listing: the core phrases are translated, candidate local phrasings are measured in each locale's test market, and the best are used. A locale that fails does not stop the others; get_optimizer lists failedLocales and lastError. Background job.

optimizer_edit_locale Edit a locale draft

Change fields of one locale's draft listing (empty string clears a field).

optimizer_pick_phrase Pick local phrasing

In one locale draft, use a different measured candidate phrase for a core phrase (from that locale's candidates in get_optimizer).

optimizer_reset Reset optimizer

Discard all options, the choice and every locale draft for the project.

get_next_version Next app version

The editable app version on the developer console (if any) and the version string the app would suggest for publishing.

publish_listing Publish listing to the store

DESTRUCTIVE / LIVE: pushes the chosen listing and every ready locale draft to App Store Connect or Google Play Console, changing what real users see. Only call after the owner has reviewed the exact listing text and explicitly told you to publish in this conversation; never on your own initiative and never as part of a larger plan they approved in general terms. Requires a connected console. The app then shows the owner a confirmation dialog listing the store, app, version, locales and fields; nothing is published unless they click Publish there (no answer within ~2 minutes = denied, error code not_approved). Background job once approved; follow with wait_for_jobs and report the outcome.

ask_assistant Ask the ASO assistant

Send a message to the in-app ASO assistant for a project (keywords or optimizer scope). It PROPOSES keyword / listing changes (status proposed) but applies nothing by itself; review them with the owner, then call apply_assistant_changes or dismiss_assistant_changes. Background job; read the reply with get_assistant_thread after wait_for_jobs.

get_assistant_thread Assistant conversation

Recent messages of the in-app ASO assistant for a project (keywords or optimizer scope), including keywords it mentioned and the changes it proposed with their status (proposed / applied / dismissed / failed).

apply_assistant_changes Apply assistant proposals

Apply changes the assistant proposed in one of its messages (ids from get_assistant_thread, e.g. "c0"; omit changeIds for every still-proposed change). Already applied or dismissed changes are skipped. Only apply what the owner agreed to.

dismiss_assistant_changes Dismiss assistant proposals

Mark changes the assistant proposed in one of its messages as dismissed (omit changeIds for every still-proposed change). Nothing in the project changes.

clear_assistant Clear assistant conversation

Delete the assistant conversation history of a project.

connect_console Connect developer console

Connect an App Store Connect API key (apple: keyId, issuerId, private key .p8) or a Google Play service account (google: service-account JSON, optional package names). Pass FILE PATHS (privateKeyPath / serviceAccountPath; files must be .p8/.pem/.json/.txt in the owner's Downloads, Desktop or Documents folder) so secrets never enter the conversation; the bridge reads them locally and the app stores them in the OS keychain. Credentials are never returned. Needed for console apps, publishing and own-app metadata.

test_console Test console account

Verify a connected console account still works (updates its status in list_console_apps).

disconnect_console Disconnect console account

Remove a console account and delete its stored key from the keychain. Ask the owner first.

connect_popularity Connect popularity source

Connect a source of REAL keyword popularity: apple_ads (Apple Ads API: clientId, teamId, keyId, private key, optional orgId), google_ads_planner (Google Ads Keyword Planner: developerToken, customerId, refreshToken, oauthClientId, oauthClientSecret, optional loginCustomerId) or imported (a popularity export file at filePath). Prefer file paths for keys. Secrets go to the OS keychain and are never returned. Then call fetch_popularity.

disconnect_popularity Disconnect popularity source

Disconnect a popularity source and delete its stored credentials. Ask the owner first.

update_settings Update settings

Change app settings; only the keys you pass change. Use set_ai_provider for the AI provider/model.

get_ai_status AI providers

Status of the local AI providers the app uses for brainstorming, suggestions, the optimizer and the assistant: installed / signed in / ready, current model and the next setup step when not ready.

No parameters.

set_ai_provider Choose AI provider

Select the local AI provider (and optionally model) the app uses for generation. Check readiness with get_ai_status first.

test_ai_provider Test AI provider

Send a tiny test prompt through a provider and record latency / errors (see get_ai_status).

import_file Import keywords file

Import an Astro export or a CSV of apps / keywords from a local path (must be a .csv/.tsv/.txt/.json file in the owner's Downloads, Desktop or Documents folder). format astro without path reads Astro's own database on this Mac: its popularity becomes real popularity and each Astro app's phrases join the tracked app with the same App Store id. previewOnly:true just reports what would be imported (rows, apps, keywords, countries). With projectId the phrases are added as keywords of that project; otherwise apps become projects (optionally in folderId). Background job.

export_data Export board / history / optimizer

Export a project's board, rank history or optimizer drafts as CSV or JSON. By default returns the content (cut at maxChars); with saveToFile:true writes the file into the app's exports folder instead.

wait_for_jobs Wait for background work

Block until background work changes state: returns as soon as a job finishes (done / failed / stopped), or when nothing is queued or running, or after timeoutSeconds (max 50). With jobId, waits for that job only; with projectId, for that project's jobs. Call it repeatedly after any tool that queued work until idle is true, then read the results. Reports progress of jobs still running.

stop_job Stop a job

Stop a queued or running background job (rank check, AI generation, import, ...). Work already done is kept.