plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "handler",
  "version": "1.0.6",
  "description": "Find the outlier TikToks winning in your app's niche, see why each one worked, and draft videos in ChatGPT. Nothing is made until you click Make it.",
  "author": {
    "name": "Agni AI FZCO",
    "email": "admin@gethandler.ai",
    "url": "https://gethandler.ai"
  },
  "homepage": "https://gethandler.ai/mcp",
  "keywords": [
    "tiktok",
    "ugc",
    "app marketing",
    "outliers",
    "research"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Handler",
        "shortDescription": "TikTok winners for your app",
        "longDescription": "Handler finds the TikToks beating their own account's average in your niche and breaks down why each one worked. Connect it and ChatGPT can read your Handler research and act on it when you ask, so you can pull this week's winners, look up a competitor's account, or draft a slideshow from a post you like without switching tabs.\n\nWhat ChatGPT can read:\n- Winners for your app's niche, or across every industry, filtered by format (talking head, silent UGC, app demo, slideshow and more). Results show as visual cards with the cover, outlier multiple, Pull score, views and a link to the post.\n- Any post's breakdown: its outlier and Pull scores, why it works, what it sells, and what the comments say.\n- Your research library, saved posts and collections.\n- Your AI creators, render status and finished outputs.\n\nWhat ChatGPT can do when you ask:\n- Set up your app from its App Store, Play Store or website link.\n- Save a post to your library or a collection.\n- Pull a TikTok link into your library.\n- Draft a video or slideshow for you to review. Nothing is made yet.\n- Make a draft you confirm. This is the only action that uses your Handler balance.\n\nWho it is for: mobile app founders and marketers who grow their app with TikTok and UGC.\n\nLimits: nothing is made until you click Make it on a draft, and drafts expire after 30 minutes. Handler can't post, build creators or delete anything from ChatGPT.",
        "developerName": "Agni AI FZCO",
        "category": "Data & Analytics",
        "capabilities": [
          "Find outlier TikToks winning in your app's niche or across every industry",
          "Explain why a post worked: scores, hook, format and comment read",
          "Set up your app from its App Store, Play Store or website link",
          "Save posts and pull TikTok links into your Handler library",
          "Draft a video or slideshow, then make it when you click Make it",
          "Show finished renders with a link back to Handler"
        ],
        "websiteURL": "https://gethandler.ai/mcp",
        "supportURL": "https://gethandler.ai/about",
        "privacyPolicyURL": "https://gethandler.ai/privacy",
        "termsOfServiceURL": "https://gethandler.ai/terms",
        "defaultPrompt": [
          "What are the top outlier TikToks in my app's niche this week?",
          "Find slideshow winners across every industry I could adapt for my app",
          "Draft me a 6-slide slideshow for my app"
        ],
        "brandColor": "#FF5733",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Set up an app from a link",
              "prompt": "Set up my app in Handler: https://apps.apple.com/us/app/duolingo-language-lessons/id570060128",
              "tools_triggered": "set_up_brand",
              "expected_behavior": "ChatGPT asks to allow set_up_brand. After approval, a short summary (app name, industry, niche) and a grid of 6 winning TikToks in that niche."
            },
            {
              "description": "Find winners",
              "prompt": "Show me the top slideshow outliers in education this week.",
              "tools_triggered": "find_winners",
              "expected_behavior": "A card grid of posts with Outlier and Pull scores and links. Read-only, no confirmation."
            },
            {
              "description": "Explain a post",
              "prompt": "Break down the first one - why did it work?",
              "tools_triggered": "explain_post",
              "expected_behavior": "A breakdown of what the post is, why it works and what the comments say."
            },
            {
              "description": "Draft, then make a slideshow",
              "prompt": "Draft me a 6-slide slideshow for my app about learning a language in 5 minutes a day.",
              "tools_triggered": "draft_video, make_video",
              "expected_behavior": "ChatGPT asks to allow draft_video, which saves a draft and spends nothing. A draft card shows the slides, the creator, the price (about 24 credits) and the balance, with Make it and Open in Handler. Clicking Make it (or saying Make it) triggers make_video, ChatGPT asks to allow it, then it answers that the render has started. The balance drops by exactly the price shown, once."
            },
            {
              "description": "Check the render",
              "prompt": "Is my slideshow done? Show it to me.",
              "tools_triggered": "list_generations, get_outputs",
              "expected_behavior": "A few minutes later, a card shows the finished slideshow with Open in Handler."
            }
          ],
          "negative": [
            {
              "description": "Delete is refused",
              "prompt": "Delete the post I saved and remove my brand."
            },
            {
              "description": "Make with an expired draft: run the draft step, wait 31 minutes, then ask to make it. It answers that the draft expired and nothing was charged.",
              "prompt": "Make that draft now."
            },
            {
              "description": "Make with too few credits, on a Growth account below 24 credits or a Starter account. No Make it button, or it answers that nothing was charged.",
              "prompt": "Draft me a slideshow about budgeting and make it."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Handler's connector does not sell products or process payments. It spends credits the user already has, and only after they confirm a draft with Make it.",
        "demo_recording_url": "https://gethandler.ai/review/handler-demo-v2.mp4"
      },
      "publication": {
        "release_notes": "Handler can now act on your research, not only read it. Set up your app from its App Store or website link, save posts, pull a TikTok into your library, and draft a video or slideshow that shows its price before anything is spent. Nothing spends credits until you click Make it on a draft, and drafts expire after 30 minutes. Finished renders show up in chat with a download link."
      },
      "apps": "./.app.json"
    }
  }
}