MCP App Store
by KeenEthics
Ranksy icon

Ranksy MCP Server for ChatGPT

By Ranksy

Overview

Ranksy is Shopify App Store analytics for app developers. It puts keyword rankings, listing traffic, installs and Partner API revenue in one place. This app lets ChatGPT read your Ranksy data and public Shopify App Store data, so you can ask about your apps in plain language. What you can ask about: - Your apps: category and keyword rankings, ranking history, reviews, tracked competitors and a listing scorecard. - Revenue from the Shopify Partner API: MRR, subscriptions, installs and uninstalls, trials, churn, cohort retention, usage billing, transactions and customer lifetime value. - Listing traffic: traffic sources, the listing conversion funnel, and which keywords and categories brought installs. - Shopify App Store ads: spend, cost per install, keywords, search terms, spend without installs, and recommendations. - Any public app or category: search, listing details, rankings, reviews, recent pricing and feature changes, top movers, similar apps and category stats. - Listing drafts: suggestions for your app's name, subtitle, introduction, details and features, checked against Shopify's listing limits. - Charts: many answers show an inline chart you can switch to a table. Most tools only read data. A few write to your Ranksy account, and only when you ask: customer notes, tags and tasks, goals, your ads cost-per-install goal and the status of ads recommendations, saved listing-improvement drafts, starting an AI ads strategist run, and the copy on your Ranksy-hosted ad landing page. Nothing is changed on the Shopify App Store or in your Shopify Partner account. You need a Ranksy account. You sign in with OAuth, and ChatGPT sees the data of your current Ranksy team. Revenue, traffic and ads data appear once those integrations are connected in Ranksy.

How to connect

  1. ChatGPT: Open the Ranksy listing in the ChatGPT app directory and choose Connect. ChatGPT listing Ranksy exposes 89 tools here.

Tools

create-goal

ChatGPT
Create a goal for one of the team's apps with one or more measurable targets. metric_type is one of mrr, usage_revenue, active_installs, daily_installs, churn_rate, keyword_rank (call get-goals for the full catalog). direction defaults per metric (gte for revenue/installs, lte for churn/rank). A target can measure the current value (default) or a rolling average: pass mode=rolling_avg with window_days (7, 14 or 30), or pass window_days alone to infer rolling_avg. Averaging works for mrr, usage_revenue, daily_installs and churn_rate, uses completed calendar days ending yesterday, and hits only after the average meets the threshold for window_days consecutive completed days. Averaged MRR is reported as "MRR growth per day" in dollars per day. keyword_rank targets need a keyword. The goal is evaluated immediately and returned with its current progress.

customer-notes-create

ChatGPT
Create a private note on a customer. Accepts installation_id (numeric) or customer (store name or myshopify.com domain) to identify the customer, plus title and body. Optional remind_at (plus remind_user_id or remind_email, which must be a team member) creates a follow-up task due at that time. Returns the created note.

customer-notes-delete

ChatGPT
Delete a note from a customer. Provide note_id to identify the note. Returns confirmation on success.

customer-notes-list

ChatGPT
List all notes for a customer. Accepts installation_id (numeric) or customer (store name or myshopify.com domain). A store name or domain resolves to the newest installation, the one the web customer profile shows. Returns id, title, body, author, the follow-up reminder (remind_at, remind_user_id, task_id) and timestamps.

customer-notes-update

ChatGPT
Update an existing note on a customer. Provide note_id to identify the note, plus any fields to change (title, body, or both). Returns the updated note.

customer-tag-attach

ChatGPT
Attach a customer tag to one installation for one of your apps. Creates the tag in that app namespace if missing.

customer-tag-detach

ChatGPT
Detach one customer tag from one installation. The tag remains available in the app namespace.

customer-tag-sync

ChatGPT
Replace all tags on one customer installation. Empty names arrays are rejected to prevent accidental wipes.

customers-filter-by-tags

ChatGPT
Find customer installations that match any or all supplied tags for one of your apps, newest install first. Test stores are excluded unless include_test is true (same rows as the web Customers page and API v1).

customers-tags-list

ChatGPT
List customer tags for one of your apps, scoped to that team app, sorted by usage count then name.

get-active-trials

ChatGPT
Get the shops currently on trial for an app: the live active-trial count plus the list of those shops (plan, price, trial end date, days remaining), ordered by trial end date soonest-first. Uses the canonical Shopify on_trial definition — the same count the dashboard overview, Trials page and API report.

get-ad-keyword-performance

ChatGPT
Show which ad (sponsored) keywords are performing vs wasting budget. Returns installs, pageviews, conversion rate, and organic rank comparison for each ad keyword.

get-ads-audience

ChatGPT
Who the Shopify App Store ads of one of YOUR apps reach and convert: spend, impressions, clicks, installs, CTR, install rate, CPC and CPI split by country, by device (desktop, mobile) and by Shopify plan of the store, each with its share of spend, sorted by spend. Works for the whole app or one campaign, including category and homepage campaigns. Uploaded CSV reports exported without dimensions carry no split.

get-ads-goal

ChatGPT
The goal the Shopify App Store ads of one of YOUR apps are judged against: the target cost per install (target_cpi), and the target ROAS for members with revenue access. Also the blended CPI of the period (spend divided by installs), which the optimizer and the restructure plan fall back to when no target CPI is saved. When no target CPI is saved the result has needs_goal: true and a goal_question: ask the app developer that question, then save the answer with set-ads-goal. Call this FIRST in any ads review.

get-ads-keywords

ChatGPT
Keyword performance of the Shopify App Store ads of one of YOUR apps (impressions, clicks, installs, spend, CTR, install rate, CPC, CPI, average position). With campaign: that campaign's keywords with bid, match type (broad or exact), status, the suggested bid range, where the bid sits against it (below, within, above) and flags such as spend_no_installs. Without campaign: keywords combined across all campaigns. Category and homepage campaigns have no keywords.

get-ads-organic-vs-paid

ChatGPT
Paid Shopify App Store ads keywords of one of YOUR apps next to the app's organic rank for the same keyword, to see where it pays for traffic it already gets for free. Per keyword: verdict, organic rank, ad rank, organic and ad installs, ad spend and CPI. Spend and paid keywords follow the period; ranks and organic installs come from a rolling window of at least the last 30 days (up to 365 for older start dates). Needs rank tracking and Google Analytics search data on the app.

get-ads-overview

ChatGPT
Shopify App Store ads overview for one of YOUR apps: spend, impressions, clicks, installs, paying customers, CTR, CPC, CPI and CAC for the period (last 30 days by default), the funnel (impressions to clicks to installs to paying customers) with the conversion rate of each step, and one row per campaign (ad type search, category or homepage; status; daily budget; the funnel step where it falls furthest below the account). Pass compare=true to also get the previous equal-length period and how each funnel step moved. Start here, then drill into a campaign with get-ads-keywords or get-ads-search-terms.

get-ads-recommendations

ChatGPT
The Ranksy ads optimizer's ranked advice for the Shopify App Store ads of one of YOUR apps, the same list as the Optimizer page: add a keyword, add a negative, pause a keyword, raise or lower a bid, stop paying for an organic rank, exclude a country / plan / device, change a campaign budget. Each item has the action, the reason, the evidence, the monthly impact, a confidence (high, medium, low), and its state (done or dismissed, or null when still open). Rules are fixed and judged against the target CPI (see get-ads-goal); with no target saved they are judged against the period's blended CPI and the result says so with needs_goal: true. Money is scaled to a 30-day month. Mark advice with mark-ads-recommendation using the item key.

get-ads-restructure-plan

ChatGPT
The Ranksy campaign restructure plan for the Shopify App Store search ads of one of YOUR apps, the same plan as the Restructure view of the Optimizer page: the problems found in today's campaigns, the campaigns as they are, a proposed set of campaigns grouped by performance (not intent), a daily budget split that adds up to the current total, and the migration steps. status and the messages say in plain language whether a restructure is proposed, and if not, why (too little data, already well structured). It is judged against the target CPI (see get-ads-goal). The plan is computed from the ads data in the period and cached for a few minutes. Quote its numbers exactly; do not recalculate them.

get-ads-search-terms

ChatGPT
The actual searches that triggered the Shopify App Store ads of one of YOUR apps, with the keyword each one matched, spend, clicks, installs, CPI and average position, sorted by spend. Each term carries not_a_keyword (the app does not bid on this exact term), converting_not_yet_keyword (it earns installs but is not a keyword yet) and spending_no_installs. Filter with flag: not_a_keyword, no_installs or converting. Category and homepage campaigns have no search terms.

get-ads-strategy

ChatGPT
The newest AI strategist run for the Shopify App Store ads of one of YOUR apps in this period and with these filters, whatever its status (queued, generating, completed, failed). A completed run holds the strategy (summary, target architecture, campaign notes, critique of the restructure plan, keyword ideas, risks and a review checklist) and stale: true when the restructure plan has changed since it was written. run is null when none exists: start one with run-ads-strategist, then poll this tool. Needs the ai.access team permission, like the Optimizer page.

get-ads-trend

ChatGPT
Shopify App Store ads performance over time for one of YOUR apps: spend, impressions, clicks, installs, CTR, CPI and average position per day or per week, plus what changed in the same period so you can explain a shift. changes is the ads setup change log (bids, budgets, keywords added or removed, campaigns paused) in plain words; listing_events are app listing edits and new reviews. Days with no synced ads data are absent from the series.

get-ads-wasters

ChatGPT
Where the Shopify App Store ads of one of YOUR apps spend money without results, found with fixed rules. keyword_waste groups keywords into dead_spend, cannibalizing_organic, overpriced, click_no_install and impression_hogs (each keyword in at most one group, with the rule that matched and the spend involved). negative_keyword_candidates lists search terms with clicks but no installs, search terms with impressions but no clicks, and themes of irrelevant searches such as payments or shipping. This is data, not advice: check a term against the app before blocking it.

get-app-info

ChatGPT
Get public listing information for any Shopify app(s). Works with any app slug for competitor research. Use search tool first to find slugs.

get-app-listing

ChatGPT
Get the current Shopify App Store listing for an app including name, subtitle, introduction, details, features, and character counts. Use this to understand what needs improvement.

get-app-rankings

ChatGPT
Get category and keyword rankings for ANY public app in the Shopify App Store. No ownership required.

get-attribution-data

ChatGPT
Get marketing attribution data showing which channels drive revenue and conversions. Supports multiple attribution models. channel_attribution uses GA4 first-touch and matched paid-social last-click. The model affects keyword_attribution and model_comparison only; see channel_attribution_model.

get-cannibalization-report

ChatGPT
Identify keywords where organic and paid ads overlap (cannibalization), keywords where ads are essential, and irrelevant ad keywords wasting budget. Helps optimize ad spend.

get-categories-stats

ChatGPT
Get statistics across all Shopify App Store categories. Find categories with best/worst ratings, most apps, most reviews. Use for market research and identifying opportunities.

get-category-apps

ChatGPT
List all apps ranked in a Shopify App Store category with their positions. Use for market research and competitive analysis.

get-category-insights

ChatGPT
Analyze a Shopify App Store category - common complaints, feature gaps, ratings distribution, and sentiment analysis.

get-category-rankings

ChatGPT
Get current category ranking positions for ANY app in the Shopify App Store. No ownership required — works with any public app slug.

get-channel-daily

ChatGPT
Get the per-day, per-channel series for an app over a period: visitors, pageviews, installs, trials, trial conversions and MRR per (date, channel). Rows are sparse — only pairs with activity appear. Basis: pageviews/visitors use the event's own channel on that UTC day; installs are install-day, first-touch channel, reconciled to the real-only install truth; trials/paid use lifecycle event dates attributed to the shop's install channel (30-day lookback). Real merchants only.

get-churn-analysis

ChatGPT
Get churn analysis including logo churn rate, revenue churn rate, and churned customer details from the Shopify Partner API.

get-churned-customers

ChatGPT
Get per-shop churned customer list with lifetime revenue and last plan info.

get-cohort-retention

ChatGPT
Get install or subscription cohort retention matrices for a Shopify app: for each acquisition cohort (day/week/month), the share of merchants still installed / still paying at each later period. Rows can also be grouped by first-touch traffic source (group_rows=source) to compare retention quality across acquisition channels.

get-competitor-listings

ChatGPT
Get the full listing content (name, subtitle, introduction, details, features) from competitor apps. Use this to see what successful competitors are doing and find patterns to emulate.

get-conversion-funnel

ChatGPT
Get the conversion funnel for an app over a period: installs, trial starts, and trial conversions, with stage conversion rates and revenue. Matches the attribution dashboard funnel. Also returns trial_conversion — THE trial conversion rate, converted / settled (converted + cancelled), excluding trials still running; is_provisional is true while the cohort has not fully ended, and a rate of 0 with settled=0 means no trial has ended yet (no signal), not a 0% conversion rate.

get-customer-lifecycle-events

ChatGPT
Get per-shop customer lifecycle events (installed, trial started, subscribed, churned, etc.) from the customer_lifecycle_events table.

get-customer-ltv

ChatGPT
Get per-customer lifetime value (LTV) ranking: the gross revenue actually collected from each shop over its lifetime, with plan, current MRR, and attribution. Lists the current paying customers.

get-customer-team-apps

ChatGPT
List the other apps from the current team that this merchant (shop) has installed, split into active and churned. Use to spot multi-app merchants for cross-sell or churn-risk.

get-goals

ChatGPT
List the team's goals with progress: each goal has status (active/achieved/missed/archived), deadline, overall progress_percent, and its targets (metric, target_value, current_value, direction, mode, window_days, hold_progress, hit_at). Optionally filter by app_slug or status, or pass goal_ulid to fetch one goal with freshly re-evaluated values. Also returns the metric_types a goal can target and the rolling-average modes/windows (use with create-goal); averaged MRR targets are labeled "MRR growth per day".

get-installations

ChatGPT
Get installation metrics from the Shopify Partner API. summary.total_installs is new installs plus reinstalls (reactivations); summary.total_uninstalls is uninstalls plus deactivations (store frozen or closed); summary.breakdown lists each event {new_installs, reinstalls, uninstalls, deactivations}. Also total_reactivations, total_deactivations, net installations (total installs - total uninstalls), active installs at the end date, and a per-period breakdown (each period row has installs and uninstalls as the same sums, plus its own breakdown object). Real stores only unless include_test is true. meta.last_synced is the last successful end-to-end Partner pipeline completion, not a data-through timestamp; meta.partner_sync carries the sync health, last error, and the newest install row held (data_through).

get-installs-by-category

ChatGPT
Get installation metrics broken down by app store categories from BigQuery analytics.

get-installs-by-keyword

ChatGPT
Get installation metrics broken down by search keywords from BigQuery analytics.

get-keyword-apps-rankings

ChatGPT
Get all apps ranking for a specific search keyword in the Shopify App Store. Use for keyword research and competitive analysis.

get-keyword-focus

ChatGPT
Which of the user's TRACKED keywords to work on this week for one of their apps. Every tracked keyword gets a tier from its latest organic App Store rank (defend 1-3, push 4-10, striking 11-24, long_shot 25-50, off_radar) and a priority score from demand, how much the keyword's top 10 churns, 7-day momentum and 14-day installs. Returns the ordered focus list with a plain-language reason and the single action to take per keyword, tier counts, and the tracked keywords that share a results page (clusters) and move together. Use this before improve-listing to choose focus_keywords.

get-keyword-installs-by-source

ChatGPT
Get keyword installation metrics split by organic vs sponsored (ad) source. Shows which keywords drive installs from organic search vs paid ads, with share percentages.

get-keyword-rankings

ChatGPT
Get current keyword ranking positions for ANY app in Shopify App Store search. No ownership required — works with any public app slug.

get-outranked-keywords

ChatGPT
Get keywords where competitors rank higher than the user's app. These represent opportunities to improve search visibility by optimizing listing content for these terms.

get-ranking-history

ChatGPT
Get historical ranking data for ANY app in a category or keyword to see trends over time. No ownership required — works with any public app slug.

get-recent-reviews

ChatGPT
Get recent reviews from the Shopify App Store - filter by category, app, rating, or sentiment. Use for market and sentiment research.

get-recent-updates

ChatGPT
Get recent app listing changes in the Shopify App Store - pricing changes, feature updates, name changes, and more.

get-revenue-overview

ChatGPT
Get revenue metrics including MRR, monthly revenue, growth rates, and revenue trends from the Shopify Partner API. Includes usage-based billing revenue: MRR figures are usage-inclusive, this_month carries the calendar-month usage_revenue/usage_shops split, and usage_history is the per-month usage revenue series. For a deeper usage drill-down (daily series, top usage-spending shops) use get-usage-revenue. meta.last_synced is the last successful end-to-end Partner pipeline completion; meta.partner_sync carries sync health and data_through.

get-reviews

ChatGPT
Get user reviews from the Shopify App Store for any public app. Includes ratings, review content, country, and developer replies. For apps YOUR team owns, each review also carries a best-effort "domain" (the reviewer shop's myshopify domain) plus "shop_country" — these come from your own Partner API attribution and are omitted for apps you do not own. domain is null for reviews that could not be attributed to an installing shop (~6-33%); no reviewer email is available, so domain is the only join key. Domains are Shopify hashes (e.g. g9mjcy-je.myshopify.com) — match them exactly, never fuzzy-match against a store name.

get-scorecard

ChatGPT
Get the competitive health scorecard for one of YOUR apps: a weighted overall score (0-100) plus four sub-scores — listing_quality, keyword_performance, reviews_reputation, visibility — each with its detailed breakdown, prioritised improvement opportunities, and a head-to-head competitor comparison. Team-scoped (requires app ownership). Reads the cached scorecard and only recomputes (no-AI, pure-DB) when it is missing, stale (>24h), or refresh=true. When the team follows no competitors, the score is computed against a PROVISIONAL set and is_provisional is true.

get-shopify-guidelines

ChatGPT
Get Shopify App Store listing guidelines, character limits, best practices, and anti-patterns to avoid. Essential reference for creating compliant, high-quality listing content.

get-similar-apps

ChatGPT
Discover CATALOG-SIMILAR apps for ANY app — the same list as the app's Similar apps page in Ranksy: apps with similar functionality (listing descriptions), shared features and categories, ranked by similarity score. This is public market-research discovery and works with any app slug; ownership is NOT required. This is NOT your tracked/followed competitor set — for the competitors a team explicitly follows (with head-to-head intelligence), use get-tracked-competitors instead.

get-store-installs

ChatGPT
Get per-store install list with install source (first-touch traffic channel, keyword, surface), uninstall reasons (canonical taxonomy + raw description), Shopify store profile (country, city, currency, plan, timezone), and current status. Use to analyze install attribution and churn per store and link with Mixpanel via shop_id.

get-subscriptions

ChatGPT
Get subscription data from the Shopify Partner API: a canonical summary and plan distribution, PLUS a paginated per-subscriber list. Each subscriber row includes its activation and cancellation dates, plan, status, and amount. Filter the list by status (e.g. cancelled), plan, billing interval, and activation/cancellation date ranges (activated_after/before, cancelled_after/before), and sort by activated_at or cancelled_at. Use these to build monthly cohorts, net-adds curves, and churn analyses — e.g. which accounts on a given plan cancelled in a specific month.

get-team-app-details

ChatGPT
Get detailed information about YOUR app including integration status (Partner API, Analytics). For competitor/market research, use get-app-info instead.

get-top-movers

ChatGPT
Find apps with the biggest ranking changes (gainers and losers) in the Shopify App Store. Use to identify trending apps.

get-tracked-competitors

ChatGPT
Get the team's TRACKED (followed) competitor set for one of YOUR apps, plus the head-to-head competitor intelligence the dashboard surfaces: keyword overlap, outranking win/loss stats, reviews comparison, pricing distribution, and advertising activity. Team-scoped — requires app ownership. When the team follows no competitors yet, a PROVISIONAL set (embedding-similar → top-category apps) is returned and is_provisional is true. This is NOT public market discovery — for catalog-similar apps for ANY slug, use get-similar-apps instead.

get-traffic-keywords

ChatGPT
Get keywords that are driving installs for an app. These keywords should be incorporated into listing content to maintain and improve search visibility.

get-traffic-overview

ChatGPT
Get traffic metrics including sessions, page views, installs, conversion rate, and traffic source / geographic breakdown. key_metrics.installs.value is total installs (new installs plus reinstalls) and key_metrics.installs.breakdown lists each event {new_installs, reinstalls, uninstalls, deactivations}. Headline metrics match the dashboard Traffic page. paid_social remains the combined total; its platform_breakdown contains Meta, Reddit, TikTok and unidentified networks. Defaults to the last 30 days.

get-transactions

ChatGPT
Get transaction history including sales, refunds, credits, and metered usage charges from the Shopify Partner API. The summary breaks the headline gross_revenue down with a usage_revenue subtotal, and type=usage filters the list to usage-charge transactions only.

get-uninstall-reasons

ChatGPT
Get aggregate breakdown of uninstall reason codes with counts and percentages. The survey is multi-select, so percentages are a share of uninstalls and can sum to more than 100%.

get-usage-metrics

ChatGPT
Get per-event_handle aggregated app-event usage for an app: for each event handle in the period, the event count and the summed value (from the events the app reports to /track, including custom usage events like sms_sent), plus a bucketed trend series and the billed-usage total. Filter by event_handle (comma-separated) and/or a single shop (myshopify domain) to drill into one customer. This is the same data as the in-app Usage Events report and the /usage-metrics API.

get-usage-revenue

ChatGPT
Get usage-based (metered) billing revenue for an app: daily usage revenue time series, summary totals (revenue, unique shops, charge count, usage ARPU, subscription MRR vs usage split), and the top usage-spending shops for the period. Only meaningful for apps billing on usage (subscription_plus_usage / pure_usage) — the same data as the web Usage tab. Real stores only unless include_test is set.

improve-landing-page

ChatGPT
Prepare the copy for an app's Ranksy-hosted ad landing page. The page shows a headline, a description and feature cards. They use the App Store listing text unless the team sets custom copy, and custom copy helps the page pass ad review, because pages that repeat the listing can be flagged as low quality. This tool saves nothing and calls no model. It returns the copy the page shows now, the listing text, the character limits, the page URLs (preview_url renders the page without firing ad pixels) and a writing brief: instructions (the system prompt), prompt (the user prompt) and json_schema (the shape of the output). Workflow: 1. Call this tool with app_slug, and with brief when the user names an angle, an audience or points to stress. 2. Write the copy with instructions as the system prompt and prompt as the user prompt, in the shape of json_schema. Keep every field within its limit. 3. Show the draft to the user. After they approve it, call save-landing-page-copy.

improve-listing

ChatGPT
Prepare a complete, ready-to-execute listing improvement brief that mirrors the in-app AI flow. The tool gathers all the context (app listing, traffic keywords, outranked keywords, ranking impact patterns, competitor listings, Shopify guidelines), creates a tracked ListingImprovement record, and returns per-field bundles containing the exact system instructions, user prompt, and JSON schema you must follow when generating each suggestion. Workflow: 1. Call this tool with app_slug (and optionally focus_keywords, selected_fields, competitor_app_ids, app_description). 2. For EACH field in the response, generate a structured suggestion using the bundle's instructions as the system prompt, prompt as the user prompt, and json_schema as the required output shape. Do not paraphrase the prompts — they encode character limits, anti-patterns, and ranking intelligence. 3. Validate every suggestion: character_count must be ≤ character_limit and the suggestion must use 90-100% of the character budget. 4. Call save-listing-improvement with the returned generation_id and the array of all generated improvements to finalize.

list-team-apps

ChatGPT
Lists YOUR Shopify apps (apps you own/manage via your teams). Returns app slugs with Partner API and Analytics integration status. Use for your own app data, not market research.

mark-ads-recommendation

ChatGPT
Mark one optimizer recommendation of one of YOUR apps as done (the app developer made the change), dismissed (not relevant), or open again (clears the mark). Identify it by the key from get-ads-recommendations. The mark is shared with the Optimizer page and survives recomputation. This does not change anything in Shopify. Needs the apps.manage team permission, like marking advice in the Ranksy app.

render-chart

ChatGPT
Render a chart INLINE in the chat from data you already have. Use this whenever the user asks to "chart", "graph", "plot", or "visualize" a metric — e.g. MRR over time, installs by month, ranking history, churn trend, or a comparison across plans/categories. First fetch the numbers with the relevant data tool (get-revenue-overview, get-installations, get-ranking-history, get-churn-analysis, etc.), then call render-chart with those numbers. Provide labels (x-axis), one or more named series (y-values aligned to labels), and axis labels/units. Supports line (trends over time) and bar (comparisons).

rule-runs-list

ChatGPT
List recent runs of one CRM automation rule (fired and skipped, with the reason). Use rules-list first to get the rule id. Read-only: this is how an agent explains why an automatic task exists.

rules-list

ChatGPT
List the CRM automation rules of one app: trigger, conditions, actions, enabled state, and how many tasks they fired in the last 7 days. Read-only; use rule-runs-list to see why a task exists. Requires app_slug or team_app_ulid.

run-ads-strategist

ChatGPT
Start the Ranksy AI strategist for the Shopify App Store ads of one of YOUR apps: it reviews the restructure plan for the period and writes a campaign strategy. It runs in the background for a few minutes and uses one of the app's limited daily strategist runs, so start it only when asked or when the plan changed. Needs the ai.access team permission. Only one run can be active per app. It starts nothing when there is no restructure plan to review. Returns the run id and status: poll get-ads-strategy with the same period and filters until the status is completed or failed.

save-landing-page-copy

ChatGPT
Save the headline, description and feature cards shown on an app's Ranksy-hosted ad landing page. This replaces the copy on the live page, so call it only after the user has approved the text; improve-landing-page returns the current copy and a writing brief. Only the fields you pass change: omit a field to keep its current value, or pass null to show the App Store listing text instead. Limits: headline 120 characters, description 2000 characters, 1 to 6 features of 160 characters each. Needs the apps.manage team permission.

save-listing-improvement

ChatGPT
Save generated listing improvements to the database. Call this after generating all improvements to persist them for the user to review and apply. When you started from improve-listing, pass the returned generation_id to finalize that prepared record instead of creating a new one.

score-listing-draft

ChatGPT
Predict what a listing text change would do to one of the user's apps' App Store keyword ranks, before they publish it. Uses Ranksy's listing impact model, trained on 16,000 real listing edits: for every keyword the app ranks on, tracks, or targets, it estimates the rank 1 to 3 weeks after publishing compared with leaving the text alone. Pass up to 5 drafts to compare them. Each draft only needs the fields it changes (name, subtitle, introduction, details, features); missing fields stay as they are live. Optionally pass target_keywords to see each one's predicted rank. Each draft returns: value (higher is better; compare drafts by it), summary (keywords up, down, no clear change; lost_top10 = top-10 keywords that would drop out), warning "loses_rankings" when the draft drops keywords the app ranks on, moves (the biggest clear rank changes, "current_rank → predicted_rank"; null rank = not in the top 72), and targets. Each move carries pageviews and installs: the keyword's organic App Store search traffic over the last 30 days from the user's GA4 data (null when the app has no GA4 search data). at_risk sums that traffic over every keyword the draft drops; when a draft loses rankings, tell the user what traffic is at risk. Small effects are reported as no clear change on purpose. These are estimates, not promises.

set-ads-goal

ChatGPT
Set the goal the Shopify App Store ads of one of YOUR apps are judged against: target_cpi (the most the app developer wants to pay per install, in dollars) and/or target_roas (return on ad spend, for members with revenue access only; without it the value is NOT saved and the result says so). Pass only the fields to change; pass null to clear one. Clearing target_cpi makes the optimizer fall back to the period's blended CPI. Changes the saved goal that the Optimizer page also uses, so ask the app developer for the number first (see get-ads-goal). Needs the apps.manage team permission, like editing the goal in the Ranksy app.

tasks-create

ChatGPT
Create a CRM follow-up task, optionally tied to a customer. Requires app_slug or team_app_ulid and a title. Identify the customer with installation_id or customer (store name or myshopify.com domain), or omit both for an app-level task. Optional: body, due_at (ISO 8601), priority (low|medium|high|highest), assignee_user_id or assignee_email (must be a team member; defaults to you), column or column_id (task board column; defaults to the first one). Returns the task.

tasks-list

ChatGPT
List CRM follow-up tasks. With no arguments: all open tasks for the team across all apps, earliest due first; pass assignee=me for "what should I do today?". Narrow with app_slug/team_app_ulid, a customer (installation_id or customer, needs an app), status (open|done|all), and assignee (all|me|unassigned|<user id>). Each task has id (use with tasks-update), title, due_at, is_overdue, priority, assignee, customer, app and column (its task board column: id, name, is_done).

tasks-update

ChatGPT
Update a CRM task by task_id (from tasks-list). Complete it with status "done", reopen with "open", dismiss with "cancelled", snooze/reschedule by passing a new due_at (ISO 8601). Move it on the team's task board with column (name) or column_id: the Done column completes it, any other column reopens it. Can also change title, body, priority (low|medium|high|highest) and assignee (assignee_user_id or assignee_email; must be a team member). Only the fields you pass change. Returns the task, including its board column.

update-goal

ChatGPT
Update an existing goal by goal_ulid: change name, description or deadline, archive it (archived=true), and/or append new targets via add_targets (same shape as create-goal targets, including mode=rolling_avg with window_days 7/14/30, or window_days alone to infer rolling_avg). Only the fields you pass change. Returns the re-evaluated goal.

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/ranksy"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/ranksy)