MCP Server
sonar
app.trysonar/sonar
What this MCP does
Provides app-store optimization tools for keyword research, rankings, reviews, competitor analysis, alerts, and ASO scoring on iOS and Android.
Capabilities
Tools
52
tools
sonar_add_screenshot
Add Screenshot
Append a screen to a screenshot set (at the end; reorder with sonar_update_screenshot_set). Requires an authorized Sonar account or a write-scope API key.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['set_id'], 'properties': {'layout': {'type': 'object', 'description': 'Omit for a blank screen.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'set_id': {'type': 'string', 'minLength': 1, 'description': 'Screenshot set to append to.'}}}
sonar_alert_events
Alert Events Feed
The detected alert events for your workspace, newest first — the same feed as the in-app Recent Alerts panel and the email digest: rank drops/gains, top-10 entries/exits, new rankings, rating drops, review spikes, and competitor changes, each with a type-specific payload (app/keyword names, old vs new values). Events only exist for alert types you've enabled rules for (sonar_set_alert); detection runs once daily. Poll with `since` to react to changes programmatically. Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'type': {'enum': ['rank_drop', 'rank_gain', 'entered_top10', 'left_top10', 'new_ranking', 'rating_drop', 'review_spike', 'competitor_change', 'top_chart'], 'type': 'string', 'description': 'Filter to one alert type. Omit for all types.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max events to return (1-200). Default 50.'}, 'since': {'type': 'string', 'minLength': 1, 'description': 'Only events created at/after this ISO 8601 timestamp (e.g. "2026-08-01T00:00:00Z"). Use your last poll time to fetch only new events.'}, 'app_id': {'type': 'string', 'minLength': 1, 'description': 'Filter to events about one tracked app (Sonar app UUID or store id).'}}}
sonar_analyze_competitors
Analyze Competitors (AI)
WRITE tool — generates a fresh AI competitive insight for one of your own apps: clusters the keyword gaps vs your competitors into named opportunity themes (with a why-now narrative and per-keyword metrics), writes threat narratives for competitors climbing on your keywords, and diffs against the previous analysis. At most one analysis per app per 7 days (429 with the next available time while in cooldown — use sonar_competitor_landscape to read the current one). Requires a paid (non-trial) Indie plan and an authorized Sonar account or an API key with the write scope.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'Sonar app UUID of YOUR OWN tracked app to analyze. NOT a store id, NOT a competitor id.'}}}
sonar_app_aso_score
ASO Score
Calculate an ASO (App Store Optimization) audit score (0-100) for an app. Returns the overall score plus an itemized breakdown of checks (title length, keyword usage, screenshots, ratings, etc.) so you can identify what to improve. Works without an API key (free tier, limited daily use per IP).
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['store', 'store_id'], 'properties': {'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us", "gb", "de"). Default "us".'}, 'store_id': {'type': 'string', 'minLength': 1, 'description': 'Store-specific app identifier. iOS: numeric track ID. Android: package name.'}}}
sonar_app_changes
App Change History
Change history for a tracked app — detected releases, metadata edits, screenshot swaps, price changes, and category moves, newest first. Useful for correlating rank movements with what the app (or a competitor) changed. Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'type': {'enum': ['release', 'metadata', 'screenshots', 'price', 'category'], 'type': 'string', 'description': 'Filter to one change type. Omit for all types.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max changes to return (1-200). Default 50.'}, 'app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID — the `id` returned by sonar_list_apps or sonar_create_product. NOT a store id.'}}}
sonar_app_extract_keywords
Extract App Keywords
Extract the most likely target keywords from an app's title and description, ranked by relevance. Useful for understanding what an app (yours or a competitor) is optimizing for. Works without an API key (free tier, limited daily use per IP).
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['store', 'store_id'], 'properties': {'max': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of keywords to extract (1-50, default 20).'}, 'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us", "gb", "de"). Default "us".'}, 'store_id': {'type': 'string', 'minLength': 1, 'description': 'Store-specific app identifier. iOS: numeric track ID. Android: package name.'}}}
sonar_app_keywords
List App Keywords
List the keywords tracked for an app in the caller's Sonar workspace, with latest difficulty, popularity, results count, note, and starred_at (favorite/target marker) per keyword. Returns the tracked-keyword ids used by sonar_update_keyword_note and sonar_star_keyword, and the keyword_ids used by sonar_keyword_rankings. Cursor-paginated (default 50 per page). Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Page size (1-200). Server default applies when omitted.'}, 'app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID — the `id` returned by sonar_list_apps or sonar_create_product. NOT a store id.'}, 'cursor': {'type': 'string', 'minLength': 1, 'description': "Pagination cursor from a previous call's `next_cursor`. Omit for the first page."}}}
sonar_app_lookup
Look Up App
Look up a single app by its store ID. Returns app metadata including name, developer, category, rating, reviews, installs (Android), and price. Works without an API key (free tier, limited daily use per IP).
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['store', 'store_id'], 'properties': {'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us", "gb", "de"). Default "us".'}, 'store_id': {'type': 'string', 'minLength': 1, 'description': 'Store-specific app identifier. iOS: numeric track ID (e.g. "123456789"). Android: package name (e.g. "com.spotify.music").'}}}
sonar_app_overview
App Overview (Dashboard Scoreboard)
The dashboard's computed scoreboard for one of your apps in a single call: visibility index and share of voice (with 7-day deltas and a daily spark), ranked / top-10 keyword counts with movement, best rank, the biggest 7-day improvements and drops, the rank-distribution trend, and the actionable opportunity list (near_page_one / top_three_push / easy_target). Read this FIRST when asked how an app is doing — it's the same numbers the dashboard renders, so you don't need to recompute anything from raw rank history. Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'days': {'type': 'integer', 'maximum': 90, 'minimum': 7, 'description': 'Rank-history window in days (7-90). Default 30.'}, 'app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID of one of your own tracked apps — the `id` returned by sonar_list_apps or sonar_create_product. NOT a store id.'}}}
sonar_app_rankings
App Rank History
Rank history for an app's tracked keywords — daily ranks over the requested window, one history array per keyword. Prefer observations for daily status: ranked has a numeric rank; not_found means a completed search did not return the app (results_count is the returned search size); not_observed means no confirmed check, including legacy gaps. Never interpret an absent rank as a collection failure or assign a numeric rank to it. The legacy history array contains positive ranks only. Use this to check how rankings moved after a metadata change or to find keywords trending up or down. Cursor-paginated over keywords (default 50 per page). Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'History window in days (1-365). Default 30.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Page size (1-200). Server default applies when omitted.'}, 'app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID — the `id` returned by sonar_list_apps or sonar_create_product. NOT a store id.'}, 'cursor': {'type': 'string', 'minLength': 1, 'description': "Pagination cursor from a previous call's `next_cursor`. Omit for the first page."}, 'keyword_id': {'type': 'string', 'minLength': 1, 'description': 'Restrict to one keyword — a keyword_id from sonar_app_keywords. Omit for all tracked keywords.'}}}
sonar_app_revenue
Estimate App Revenue
Estimate monthly revenue for an app, based on install counts, ratings, and category benchmarks. Returns the dollar estimate, a confidence grade (high/medium/low) with the factors behind it, and the methodology used — always communicate the confidence alongside the number.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['store', 'store_id'], 'properties': {'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us", "gb", "de"). Default "us".'}, 'store_id': {'type': 'string', 'minLength': 1, 'description': 'Store-specific app identifier. iOS: numeric track ID. Android: package name.'}}}
sonar_app_reviews
Fetch App Reviews
Fetch user reviews for an app. Supports filtering by star rating range and sorting by recent or helpful. Useful for sentiment analysis, feature-request mining, and competitive research.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['store', 'store_id'], 'properties': {'lang': {'type': 'string', 'pattern': '^[a-z]{2}$', 'description': 'Android only: fetch one language feed (e.g. ar, fr). Omit to merge the market language plus en, es, fr, ar; coverage is not exhaustive.'}, 'sort': {'enum': ['recent', 'helpful'], 'type': 'string', 'default': 'recent', 'description': 'Sort order. "recent" returns newest first, "helpful" returns most-voted first.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of reviews to return (1-200).'}, 'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us", "gb", "de"). Default "us".'}, 'store_id': {'type': 'string', 'minLength': 1, 'description': 'Store-specific app identifier. iOS: numeric track ID. Android: package name.'}, 'max_rating': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Filter to reviews with a star rating <= this value (1-5).'}, 'min_rating': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Filter to reviews with a star rating >= this value (1-5).'}}}
sonar_app_search
Search Apps
Search apps in the App Store or Google Play by keyword. Returns ranked list of apps with metadata (results are returned in store ranking order). Works without an API key (free tier, limited daily use per IP).
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'store'], 'properties': {'num': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Number of results to return (1-50, default 10).'}, 'query': {'type': 'string', 'minLength': 1, 'description': 'Search query (e.g. "meditation", "meal planner").'}, 'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us", "gb", "de"). Default "us".'}}}
sonar_competitor_keywords
Competitor Keywords
Keywords a tracked competitor currently ranks for (last 7 days of SERP data), with difficulty and popularity per keyword. Pass own_app_id for gap analysis: keywords where the competitor ranks but your app doesn't are marked gap=missing. Cursor-paginated (default 50 per page). Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['competitor_app_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Page size (1-200). Server default applies when omitted.'}, 'cursor': {'type': 'string', 'minLength': 1, 'description': "Pagination cursor from a previous call's `next_cursor`. Omit for the first page."}, 'own_app_id': {'type': 'string', 'minLength': 1, 'description': "Sonar app UUID of your own app. When set, each keyword includes your current rank and a gap marker for keywords you don't rank for."}, 'competitor_app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID of the competitor — the `competitor.id` from sonar_track_competitor, or an `id` from sonar_list_apps where is_own is false. NOT a store id.'}}}
sonar_competitor_landscape
Competitor Landscape
The full competitive keyword picture for one of your own apps vs every tracked competitor, in one call: live stats (keyword gaps where competitors rank and you don't, winnable gaps, competitors climbing on your tracked keywords, keywords you lead), the top gap/threat/lead rows with metrics, and the latest AI insight if one was generated (opportunity clusters, threat narratives, strengths, posture). Read this before deciding which keywords to target next. Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'Sonar app UUID of YOUR OWN tracked app (an `id` from sonar_list_apps where is_own is true). NOT a store id, NOT a competitor id.'}}}
sonar_create_product
Create Product
WRITE tool — creates a product in the caller's Sonar workspace and starts tracking the given app(s). A product is the cross-store unit (one iOS + one Android app, or just one of either). Returns the product id and the Sonar app ids needed by sonar_track_keywords and sonar_track_competitor. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apps'], 'properties': {'apps': {'type': 'array', 'items': {'type': 'object', 'required': ['store', 'store_id'], 'properties': {'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us"). Optional — defaults server-side.'}, 'store_id': {'type': 'string', 'minLength': 1, 'description': 'Store-specific app identifier. iOS: numeric track ID. Android: package name.'}}, 'description': 'One store version of the product.'}, 'maxItems': 2, 'minItems': 1, 'description': '1-2 store versions: a single iOS or Android app, or one of each for a cross-store product.'}, 'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "Product name. Optional — defaults to the first app's name."}}}
sonar_create_screenshot_set
Create Screenshot Set
Create an app-store screenshot set for a product. Read sonar_screenshot_layout_guide first, then author the screens array. The set is immediately visible/editable for humans in the Screenshot Studio (studio_url in the response). Requires an authorized Sonar account or a write-scope API key.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['product_id', 'store', 'device_size'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Display name.'}, 'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'Target app store.'}, 'screens': {'type': 'array', 'items': {'type': 'object', 'description': 'A screenshot layout document ({background, layers}) — see sonar_screenshot_layout_guide. Image fields accept https:// URLs.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'maxItems': 10, 'minItems': 1, 'description': 'Initial screens, in order (max 10). Either this or template_id, not both; with neither you get one blank screen.'}, 'product_id': {'type': 'string', 'minLength': 1, 'description': 'Product the set belongs to.'}, 'device_size': {'type': 'string', 'minLength': 1, 'description': 'Device id from sonar_screenshot_devices, e.g. "iphone-6.7".'}, 'template_id': {'type': 'string', 'minLength': 1, 'description': 'Seed from a built-in template (see sonar_screenshot_layout_guide) instead of providing screens.'}}}
sonar_delete_alert
Delete Alert Rule
WRITE tool — delete an alert subscription in the caller's Sonar workspace. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Destructive
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'The alert subscription UUID — the `id` returned by sonar_list_alerts or sonar_set_alert.'}}}
sonar_delete_product
Delete Product
WRITE tool — delete a product and untrack its apps in the caller's Sonar workspace. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Destructive
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['product_id'], 'properties': {'product_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar product UUID — the `id` returned by sonar_list_products or sonar_create_product.'}}}
sonar_delete_screenshot
Delete Screenshot
Delete one screen from a screenshot set. A set keeps at least one screen — deleting the last one is rejected. Requires an authorized Sonar account or a write-scope API key.
Destructive
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['screenshot_id'], 'properties': {'screenshot_id': {'type': 'string', 'minLength': 1, 'description': 'Screen id to delete.'}}}
sonar_delete_screenshot_set
Delete Screenshot Set
Permanently delete a screenshot set and everything in it (screens, translations). Irreversible — confirm with the user before deleting work they may want. Requires an authorized Sonar account or a write-scope API key.
Destructive
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['set_id'], 'properties': {'set_id': {'type': 'string', 'minLength': 1, 'description': 'Screenshot set id.'}}}
sonar_delete_tracked_keyword
Delete Tracked Keyword
WRITE tool — stop tracking one keyword/app pair in the caller's Sonar workspace. Identify the pair by its tracked-keyword id (from sonar_app_keywords). Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Destructive
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tracked_keyword_id'], 'properties': {'tracked_keyword_id': {'type': 'string', 'minLength': 1, 'description': 'The tracked-keyword UUID — the `id` returned by sonar_app_keywords. NOT the keyword_id.'}}}
sonar_discovered_keywords
Discovered Keywords
Keywords Sonar's discovery engine surfaced for one of your tracked apps but that aren't tracked yet — ranked finds (the app already ranks, unnoticed), competitor gaps, and AI/autocomplete-sourced ideas — each with popularity, difficulty, AI relevance, and an opportunity score (0-100, best first). This is Sonar's "what should I track next" answer: read it, pick the winners, then track them with sonar_track_keywords. Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Max rows to return (1-500). Default 200.'}, 'app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID of one of your tracked apps — the `id` returned by sonar_list_apps or sonar_create_product. NOT a store id.'}, 'bucket': {'enum': ['ranked', 'gap', 'idea'], 'type': 'string', 'description': 'Filter by classification: "ranked" = the app already ranks for it, "gap" = a competitor ranks but the app does not, "idea" = verified research suggestion with no rank evidence yet. Omit for all.'}, 'source': {'enum': ['autocomplete', 'metadata', 'serp_scan', 'competitor', 'apple_ads', 'ai'], 'type': 'string', 'description': 'Filter by how the keyword was discovered. Omit for all sources.'}, 'status': {'enum': ['new', 'tracked', 'hidden', 'all'], 'type': 'string', 'description': 'Filter by row status. Default "new" — the still-actionable suggestions; "all" includes rows already tracked or hidden.'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Filter to one market (ISO country code). Omit for all markets.'}, 'min_relevance': {'type': 'integer', 'maximum': 100, 'minimum': 0, 'description': 'Only rows with AI relevance at or above this value (0-100).'}, 'min_opportunity': {'type': 'integer', 'maximum': 100, 'minimum': 0, 'description': 'Only rows with an opportunity score at or above this value (0-100).'}}}
sonar_generate_review_insights
Generate Review Insights (AI)
WRITE tool — generates a fresh AI review analysis for a tracked app from its recent reviews (praise/complaint themes, sentiment, feature requests, trend vs the previous run). At most one analysis per app+country every 90 days (429 with the next available time while in cooldown — use sonar_review_insights to read the current one); needs at least 5 recent reviews. Requires a paid (non-trial) Indie plan and an authorized Sonar account or an API key with the write scope.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID of a tracked app — your own or a competitor (an `id` from sonar_list_apps). NOT a store id.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'Reviews market (ISO country code). Insights are generated per country. Default "us".'}}}
sonar_get_app
Get Tracked App
Get full details for one tracked app in the caller's Sonar workspace: store metadata plus up to 90 daily snapshots of rating, review count, version, and installs. Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID — the `id` returned by sonar_list_apps or sonar_create_product. NOT a store id.'}}}
sonar_get_screenshot_set
Get Screenshot Set
Fetch a screenshot set in full: every screen's layout JSON plus per-screen translation overrides keyed by locale. By default inline image data is replaced with placeholders to keep the response readable.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['set_id'], 'properties': {'set_id': {'type': 'string', 'minLength': 1, 'description': 'Screenshot set id.'}, 'include_image_data': {'type': 'boolean', 'default': False, 'description': 'When false (default), inline base64 images are replaced with short placeholders to keep the response small. Set true only when you need the raw data URLs (a layout containing placeholders is rejected on update).'}}}
sonar_keyword_metrics
Keyword Metrics
Difficulty + popularity for a specific keyword (or up to 25 in bulk). Use this when you already know which keywords you care about — costs 1 credit per keyword. Works without an API key for up to 5 keywords/day (free tier, per IP); an API key removes that cap. Use sonar_keyword_search instead when you want related keyword ideas alongside metrics. A keyword the API cannot compute right away comes back as `pending` (queued on the scrape fleet, not charged) — this tool already waits and re-checks briefly; if it is still pending, call again after `retry_after_seconds`.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['store'], 'properties': {'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us", "gb", "de"). Default "us".'}, 'keyword': {'type': 'string', 'minLength': 1, 'description': 'Single keyword to fetch metrics for. Use this OR `keywords`, not both.'}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 25, 'minItems': 1, 'description': 'Bulk list of keywords to fetch metrics for (max 25). Use this OR `keyword`, not both. 1 credit per keyword.'}}}
sonar_keyword_rankings
Keyword SERP History
SERP history for one tracked keyword — which apps ranked in the top results on each measured day, newest first. Use this to see who competes on a keyword and how the top spots shifted over time. The keyword must be tracked in the caller's Sonar workspace. Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['keyword_id'], 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'History window in days (1-365). Default 30.'}, 'keyword_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar keyword UUID — a `keyword_id` from sonar_app_keywords or sonar_competitor_keywords. NOT the keyword text.'}}}
sonar_keyword_search
Keyword Research
Research a keyword and related terms. Returns difficulty (0-100), popularity score, and results count for the seed keyword plus related autocomplete suggestions. Use this to find keywords worth targeting.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'store'], 'properties': {'query': {'type': 'string', 'minLength': 1, 'description': 'Seed keyword to research (e.g. "meditation", "recipe app").'}, 'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us", "gb", "de"). Default "us".'}}}
sonar_keyword_suggestions
Keyword Suggestions
Get autocomplete suggestions for a seed keyword from the App Store or Google Play. Returns terms with a priority score (higher = more searched). Lighter and faster than sonar_keyword_search — use when you only need term ideas without difficulty/popularity scoring. Works without an API key (free tier, limited daily use per IP).
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['seed', 'store'], 'properties': {'seed': {'type': 'string', 'minLength': 1, 'description': 'Seed keyword. The store will return autocomplete suggestions starting from this term.'}, 'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us", "gb", "de"). Default "us".'}}}
sonar_list_alerts
List Alert Rules
List your alert subscriptions — each rule defines a change type (rank drops, review spikes, etc.), its scope (a specific app or org-wide), threshold, and whether it's enabled. Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
sonar_list_apps
List Tracked Apps
List the apps tracked in the caller's Sonar workspace (own apps + competitors), each with its latest snapshot (rating, review count, version, installs). Returns the Sonar app UUIDs needed by sonar_get_app, sonar_app_keywords, sonar_app_rankings, and sonar_app_changes. Cursor-paginated (default 100 per page). Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Page size (1-200). Server default applies when omitted.'}, 'cursor': {'type': 'string', 'minLength': 1, 'description': "Pagination cursor from a previous call's `next_cursor`. Omit for the first page."}}}
sonar_list_products
List Products
List your products with their linked store versions and competitor counts. Use it to discover product/app UUIDs. Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
sonar_list_screenshot_sets
List Screenshot Sets
List a product's app-store screenshot sets (metadata only: store, device size, locales, studio_url). Use sonar_get_screenshot_set for full layouts.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['product_id'], 'properties': {'product_id': {'type': 'string', 'minLength': 1, 'description': 'Product id (find it with sonar_list_products).'}}}
sonar_portfolio
Portfolio Rollup (Agency)
The whole portfolio's health in one call — for orgs managing many apps: per-app KPIs (visibility + 7-day delta, ranked/top-10 counts, net rank movement, rating, review count), org-wide totals, the biggest keyword movers in both directions, a needs-attention triage list (visibility drops, rating drops, not-ranked apps), and the best discovered-keyword opportunities across all apps. Same numbers as the /portfolio page. Requires an Agency plan (403 on other plans).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
sonar_remove_competitor
Remove Competitor
WRITE tool — remove a competitor from a product in the caller's Sonar workspace. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Destructive
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['product_id', 'competitor_app_id'], 'properties': {'product_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar product UUID — the `id` returned by sonar_list_products or sonar_create_product.'}, 'competitor_app_id': {'type': 'string', 'minLength': 1, 'description': "Sonar app UUID of the competitor to remove (the competitor's `id`, NOT a store id)."}}}
sonar_review_insights
Review Insights (AI)
The latest AI review analysis for a tracked app (your own or a competitor): what users praise and complain about as named themes with frequency, verbatim quotes, and trend movement (new / persisting / growing / improving / resolved), plus overall sentiment, surfaced feature requests, and what changed vs the previous analysis. `insight` is null if none has been generated yet — use sonar_generate_review_insights. Requires an Indie plan (trial counts).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID of a tracked app — your own or a competitor (an `id` from sonar_list_apps). NOT a store id.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'Reviews market (ISO country code). Insights are generated per country. Default "us".'}}}
sonar_scan_competitor
Scan Competitor Keywords
WRITE tool — runs an AI keyword discovery scan on a tracked competitor: generates the search terms the competitor's listing is optimized for (brand terms included), queues them for SERP verification, and verifies the first batch inline (~30s), recording both apps' ranks. Returns generated/queued/verified_now counts; the rest verify in the background over the following hours — read results with sonar_competitor_keywords. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['competitor_app_id', 'own_app_id'], 'properties': {'own_app_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'Sonar app UUID of your own app the scan compares against. The competitor must be linked to this app.'}, 'competitor_app_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'Sonar app UUID of the competitor to scan — the `competitor.id` from sonar_track_competitor, or an `id` from sonar_list_apps where is_own is false. NOT a store id.'}}}
sonar_screenshot_devices
List Screenshot Devices
List the device sizes supported for app-store screenshot sets, with their canvas dimensions (the pixel coordinate space all layouts use) and which store each belongs to. Pick a device here before sonar_create_screenshot_set.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
sonar_screenshot_layout_guide
Screenshot Layout Guide
The layout-format reference for Sonar screenshot sets. Call this ONCE before creating or editing screenshot layouts — it documents the layout JSON schema, coordinate system, image handling (remote URLs), flowing background shapes, fonts, translation overrides, and the recommended workflow.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
sonar_set_alert
Set Alert Rule
WRITE tool — create or update an alert subscription in the caller's Sonar workspace. Upserts on (type + scope): re-submitting the same type/scope updates the existing rule. Omit `threshold` for the per-type default; omit `scope_app_id` for an org-wide rule. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['type'], 'properties': {'type': {'enum': ['rank_drop', 'rank_gain', 'entered_top10', 'left_top10', 'new_ranking', 'rating_drop', 'review_spike', 'competitor_change', 'top_chart'], 'type': 'string', 'description': 'The alert type to subscribe to. top_chart = one of your own apps entered or left a store top chart (overall + its category, free/paid/grossing).'}, 'enabled': {'type': 'boolean', 'description': 'Whether the rule is active. Defaults to enabled when omitted.'}, 'countries': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}, 'maxItems': 10}, {'type': 'null'}], 'description': 'top_chart only: storefronts to watch (ISO 3166-1 alpha-2, e.g. ["us", "de"]), max 10. Omit to keep the stored list; null or [] = the countries you track keywords in.'}, 'threshold': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': "Sensitivity threshold (meaning depends on type; for top_chart it's the rank cutoff, 1-200, default 200). Omit or null to use the per-type default."}, 'scope_app_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'description': 'Limit the alert to a single app (Sonar app UUID). Omit or null for an org-wide rule covering all tracked apps.'}}}
sonar_set_screenshot_translations
Set Screenshot Translations
Write a locale's translation overrides for screens in a screenshot set (text copy, localized captures/images). Geometry and styling always come from the source layout; anything not overridden falls back to it. The locale is auto-enabled on the set. Requires an authorized Sonar account or a write-scope API key.
Destructive
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['set_id', 'locale', 'entries'], 'properties': {'locale': {'type': 'string', 'maxLength': 8, 'minLength': 2, 'description': 'Target locale code, e.g. "de-DE", "pt-BR", "zh-Hans".'}, 'set_id': {'type': 'string', 'minLength': 1, 'description': 'Screenshot set id.'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['screenshot_id', 'overrides'], 'properties': {'overrides': {'type': 'object', 'description': 'Sparse overrides keyed by layer id, e.g. {"headline": {"text": "…"}, "device": {"screenshotDataUrl": "https://…"}}. Replaces the screen\'s stored overrides for this locale wholesale.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'screenshot_id': {'type': 'string', 'minLength': 1, 'description': 'Screen this entry localizes.'}}}, 'maxItems': 50, 'minItems': 1, 'description': 'One entry per screen to localize.'}}}
sonar_star_keyword
Star Keyword
WRITE tool — stars or unstars a tracked keyword in the caller's Sonar workspace. A star marks the keyword as a favorite/target the user is actively pursuing; starred keywords carry a starred_at timestamp in sonar_app_keywords results. Idempotent: re-starring refreshes the timestamp, unstarring a non-starred keyword is a no-op. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tracked_keyword_id', 'starred'], 'properties': {'starred': {'type': 'boolean', 'description': 'true to star the keyword (mark as a favorite/target), false to unstar.'}, 'tracked_keyword_id': {'type': 'string', 'minLength': 1, 'description': 'Tracked-keyword UUID — the `id` (not keyword_id) returned by sonar_app_keywords or sonar_track_keywords.'}}}
sonar_top_charts
Top Charts
Get a store top chart (free / paid / grossing, overall or by category) with day-over-day movement: per-app rank delta, apps new to the chart, biggest movers and apps that dropped out. Use to see what's rising in a market or category. Note: summary, movers and droppedApps always describe the full top 200 — `limit` truncates the returned entries only. Movement is empty on the first day a chart is requested (no previous snapshot yet). Works without an API key (free tier, limited daily use per IP).
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['store'], 'properties': {'chart': {'enum': ['free', 'paid', 'grossing'], 'type': 'string', 'default': 'free', 'description': 'Chart type: "free", "paid" or "grossing". Default "free".'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1, 'description': 'Number of chart entries to return (1-200). Default 50.'}, 'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us", "gb", "de"). Default "us".'}, 'category': {'type': 'string', 'default': 'overall', 'description': 'Category key, e.g. "HEALTH_AND_FITNESS" (iOS) or "HEALTH_AND_FITNESS" / "GAME" (Android). Use "overall" (default) for the store-wide chart.'}}}
sonar_track_app
Track App
WRITE tool — links the second-store version of an existing Sonar product (e.g. the product already tracks the iOS app and you want to add the Android version, or vice versa). Each product holds at most one iOS + one Android app; to start tracking a brand-new app, use sonar_create_product instead. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['product_id', 'store', 'store_id'], 'properties': {'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us"). Optional — defaults server-side.'}, 'store_id': {'type': 'string', 'minLength': 1, 'description': 'Store-specific app identifier of the version to link. iOS: numeric track ID. Android: package name.'}, 'product_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar product UUID (from sonar_create_product). NOT a store id.'}}}
sonar_track_competitor
Track Competitor
WRITE tool — adds a competitor app under a Sonar product so its keywords and rankings get tracked alongside the product's own app. The product must already have its own app linked in the same store as the competitor. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['product_id', 'store', 'store_id'], 'properties': {'store': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'App store. "ios" for Apple App Store, "android" for Google Play.'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us"). Optional — defaults server-side.'}, 'store_id': {'type': 'string', 'minLength': 1, 'description': 'Store-specific app identifier of the COMPETITOR app to track. iOS: numeric track ID. Android: package name.'}, 'product_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar product UUID (from sonar_create_product). NOT a store id.'}}}
sonar_track_keywords
Track Keywords
WRITE tool — starts daily rank tracking for one or more keywords on an app in the caller's Sonar workspace. Idempotent: re-posting the same terms reports them as already_tracked instead of creating duplicates. Returns per-keyword outcomes (created / already_tracked / failed). Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id', 'keywords'], 'properties': {'app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID — the `apps[].id` returned by sonar_create_product (or sonar_track_app). NOT a store id; the store is implied by the app.'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "us"). Optional — defaults to the product\'s country.'}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'maxItems': 200, 'minItems': 1, 'description': 'Keywords to start tracking (1-200). Duplicates and already-tracked terms are reported, not duplicated.'}}}
sonar_untrack_app
Untrack App
WRITE tool — untrack an app and its associated tracking data in the caller's Sonar workspace. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Destructive
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID — the `id` returned by sonar_list_apps or sonar_create_product. NOT a store id.'}}}
sonar_untrack_keywords
Untrack Keywords
WRITE tool — bulk-untrack keywords for an app in the caller's Sonar workspace. Pass `all: true` to remove every tracked keyword, OR `ids: [...]` to remove specific ones (exactly one of the two). Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Destructive
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['app_id'], 'properties': {'all': {'type': 'boolean', 'description': 'Set true to untrack ALL keywords for the app. Mutually exclusive with `ids` — pass exactly one of `all` or `ids`.'}, 'ids': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1, 'description': 'Tracked-keyword ids to untrack (from sonar_app_keywords). Mutually exclusive with `all` — pass exactly one of `all` or `ids`.'}, 'app_id': {'type': 'string', 'minLength': 1, 'description': 'Sonar app UUID — the `id` returned by sonar_list_apps or sonar_create_product. NOT a store id.'}}}
sonar_update_keyword_note
Update Keyword Note
WRITE tool — sets or clears the note on a tracked keyword in the caller's Sonar workspace (e.g. why it's tracked, an optimization hypothesis, a reminder). Idempotent: re-sending the same note is a no-op. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tracked_keyword_id', 'note'], 'properties': {'note': {'anyOf': [{'type': 'string', 'maxLength': 1000}, {'type': 'null'}], 'description': 'Note text (max 1000 chars). Pass null or an empty string to clear the note.'}, 'tracked_keyword_id': {'type': 'string', 'minLength': 1, 'description': 'Tracked-keyword UUID — the `id` (not keyword_id) returned by sonar_app_keywords or sonar_track_keywords.'}}}
sonar_update_screenshot
Update Screenshot
Replace one screen's layout in a screenshot set. Whole-document replace — fetch the current layout, modify it, send it back. The change shows up immediately in the Screenshot Studio for human review. Requires an authorized Sonar account or a write-scope API key.
Destructive
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['screenshot_id', 'layout'], 'properties': {'layout': {'type': 'object', 'description': "The FULL replacement layout — this replaces the whole document, it does not merge. Never send a layout containing '[inline image omitted…]' placeholders; refetch with include_image_data first.", 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'screenshot_id': {'type': 'string', 'minLength': 1, 'description': "Screen id (from the set's screens array)."}}}
sonar_update_screenshot_set
Update Screenshot Set
Rename a screenshot set, replace its extra-locale list, and/or reorder its screens. Returns the updated set (with image data stripped). Requires an authorized Sonar account or a write-scope API key.
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['set_id'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'New display name.'}, 'set_id': {'type': 'string', 'minLength': 1, 'description': 'Screenshot set id.'}, 'locales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 8, 'minLength': 2}, 'maxItems': 40, 'description': 'Replaces the extra-locale list (e.g. ["de-DE","fr-FR"]). Locales removed here lose their stored translations.'}, 'screen_order': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1, 'description': "Full permutation of the set's screen ids in the new display order."}}}
History
Recent tool changes
Changed
sonar_set_alert
Sept. 27, 2026, 2:51 a.m.
Changed
sonar_alert_events
Sept. 27, 2026, 2:51 a.m.
Added
sonar_set_screenshot_translations
Sept. 17, 2026, 7:58 a.m.
Added
sonar_delete_screenshot
Sept. 17, 2026, 7:58 a.m.
Added
sonar_update_screenshot
Sept. 17, 2026, 7:58 a.m.
Added
sonar_add_screenshot
Sept. 17, 2026, 7:58 a.m.
Added
sonar_delete_screenshot_set
Sept. 17, 2026, 7:58 a.m.
Added
sonar_update_screenshot_set
Sept. 17, 2026, 7:58 a.m.
Added
sonar_get_screenshot_set
Sept. 17, 2026, 7:58 a.m.
Added
sonar_create_screenshot_set
Sept. 17, 2026, 7:58 a.m.
Added
sonar_list_screenshot_sets
Sept. 17, 2026, 7:58 a.m.
Added
sonar_screenshot_devices
Sept. 17, 2026, 7:58 a.m.
Added
sonar_screenshot_layout_guide
Sept. 17, 2026, 7:58 a.m.
Added
sonar_delete_alert
Sept. 17, 2026, 7:58 a.m.
Added
sonar_set_alert
Sept. 17, 2026, 7:58 a.m.
Added
sonar_remove_competitor
Sept. 17, 2026, 7:58 a.m.
Added
sonar_delete_product
Sept. 17, 2026, 7:58 a.m.
Added
sonar_untrack_app
Sept. 17, 2026, 7:58 a.m.
Added
sonar_untrack_keywords
Sept. 17, 2026, 7:58 a.m.
Added
sonar_delete_tracked_keyword
Sept. 17, 2026, 7:58 a.m.
Added
sonar_generate_review_insights
Sept. 17, 2026, 7:58 a.m.
Added
sonar_analyze_competitors
Sept. 17, 2026, 7:58 a.m.
Added
sonar_scan_competitor
Sept. 17, 2026, 7:58 a.m.
Added
sonar_star_keyword
Sept. 17, 2026, 7:58 a.m.
Added
sonar_update_keyword_note
Sept. 17, 2026, 7:58 a.m.
Added
sonar_track_keywords
Sept. 17, 2026, 7:58 a.m.
Added
sonar_track_competitor
Sept. 17, 2026, 7:58 a.m.
Added
sonar_track_app
Sept. 17, 2026, 7:58 a.m.
Added
sonar_create_product
Sept. 17, 2026, 7:58 a.m.
Added
sonar_portfolio
Sept. 17, 2026, 7:58 a.m.
Discover
Similar MCP servers
rankparse-mcp
io.github.abhibavishi/rankparse-mcp
Provides SEO and search marketing research including backlinks, authority, competitor gaps, Google Ads keyword metrics, and Googl…
Ai Briefing
io.github.pipeworx-io/ai-briefing
Routes research questions to structured sources including financial, scientific, government, market, news, and economic data, wit…
42matters
io.github.pipeworx-io/42matters
Provides mobile app store intelligence, SDK and chart analysis, AI visibility checks, structured research across many data source…
Ai Feeds
io.github.pipeworx-io/ai-feeds
Provides AI news feeds, AI visibility checks, and routed access to structured research and market data sources.
Textstats
io.github.pipeworx-io/textstats
Provides readability scoring, AI visibility audits, structured research across many data sources, and related research utilities.
Seo Serp
io.github.pipeworx-io/seo-serp
Provides Google organic SERP research and related routed structured-data and AI visibility capabilities.
Seo Ai Visibility
io.github.pipeworx-io/seo-ai-visibility
Checks brand visibility in LLM responses, generates llms.txt files, and provides broader routed research and structured-data look…
Always Seven
io.github.pipeworx-io/always-seven
Provides structured-data research across thousands of sources, prediction-market analysis, persistent agent memory, and AI brand-…