V-Kit

View saved version →

---
name: v-marketing-kit
description: |-
  V-Kit (Marketing Kit): the user's own ad, analytics and subscription numbers through the v-marketing-kit connector — spend, impressions, clicks, installs, events, campaigns, conversions, MRR, trials, churn, revenue, App Store reviews. Use when the question is about marketing numbers, even if the source is not named ("how much did we spend", "how many installs", "what is wrong with the campaign", "App Store sales", "reviews", "Google Play installs", "search queries"). Tools are one per operation, named mk_<source>_<operation>: Meta Ads, Facebook Pages, Instagram, TikTok Ads, Apple Ads, Google Ads, GA4, Search Console, Google Play, AppsFlyer, RevenueCat, App Store Connect and the public App Store; plus mk_status and mk_feedback_send, mk_feedback_reply, mk_feedback_list, mk_feedback_get. Several clients (agencies): name the client in each call. Start with mk_status.
metadata:
  version: "1.23.4"
  title: v-marketing-kit
---

# V-Kit (Marketing Kit)

The user's own ad, analytics and subscription numbers, read through the v-marketing-kit
connector (server marketing-kit.app). Every operation is its own tool, named
`mk_<source>_<operation>` — for example `mk_ga4_report`, `mk_meta_insights`,
`mk_revenuecat_chart`, `mk_app_store_connect_sales`, `mk_apple_lookup`. Two operations
write (`mk_appsflyer_integration_copy`, `mk_app_store_connect_analytics_enable`); everything
else only reads. `mk_status` checks the connections, `mk_feedback_send` sends a note to the
developer (`mk_feedback_reply`, `mk_feedback_list`, `mk_feedback_get` — the replies and the history). In this file `mk_<source>_*` means the whole family of one source.

| Family | What it is for |
|---|---|
| `mk_meta_*` | Meta Ads (paid Facebook and Instagram ads): spend, impressions, clicks, installs as Meta counts them, campaigns, ad sets, ads, event counters, custom conversions |
| `mk_fb_pages_*` | Facebook Pages, organic: reach, posts, engagement, followers |
| `mk_instagram_*` | Instagram professional account, organic: reach, views, followers, posts and reels |
| `mk_tiktok_*` | TikTok Ads: spend, impressions, clicks, conversions; campaigns, ad groups, ads (no organic TikTok) |
| `mk_apple_ads_*` | Apple Ads (App Store search ads): spend, impressions, taps, installs by Apple's attribution; campaigns, ad groups, keywords, negative keywords, ads, search terms, impression share; read-only |
| `mk_google_ads_*` | Google Ads: GAQL reports and lists of campaigns, ad groups, ads, conversion actions |
| `mk_ga4_*` | Google Analytics 4: events and behaviour in the app and on the site, funnels, users and sessions, realtime, metadata |
| `mk_search_console_*` | Google Search Console: organic Google search — queries, pages, clicks, impressions, CTR, position; sitemaps; URL inspection |
| `mk_google_play_*` | Google Play Console: the user's own Android apps — installs and uninstalls, estimated sales, earnings after Google's fee, subscription counts, reviews, refunds, Android vitals (crashes, ANR); read-only; reports are 3–7 days late |
| `mk_appsflyer_*` | AppsFlyer: installs and in-app events by source, aggregate and raw reports, purchase duplicates between the app and RevenueCat (`mk_appsflyer_purchase_dedup`), copy of integration settings after confirmation (`mk_appsflyer_integration_copy`) |
| `mk_revenuecat_*` | RevenueCat: subscriptions — MRR, ARR, active subscriptions and trials, revenue, churn, trial conversion, LTV, refunds, products and offerings, one customer's subscription |
| `mk_app_store_connect_*` | App Store Connect: Apple's official numbers for the user's own apps — downloads, proceeds, subscription reports, the App Store funnel (impressions → page views → downloads), sessions, crashes, reviews with replies, versions, experiments; turning on Analytics Reports after confirmation; data arrives with a one-day delay |
| `mk_apple_*` (`mk_apple_lookup`, `mk_apple_reviews`, `mk_apple_charts`) | Public App Store data of any app, no

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 4 — file references are metadata, not package contents.