plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "handler",
  "version": "1.0.3",
  "description": "Find the outlier TikToks winning in your app's niche, see why each one worked, and bring your Handler research into ChatGPT. Read-only.",
  "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 library, so you can ask for this week's winners, look up a competitor's account, or turn a breakdown into a script without switching tabs.\n\nWhat ChatGPT can do with Handler:\n- Find 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- Explain any post: its outlier and Pull scores, why it works, what it sells, and what the comments say.\n- Search your research library, and open your saved posts and collections.\n- List your AI creators and check the status of your renders.\n\nWho it is for: mobile app founders and marketers who grow their app with TikTok and UGC.\n\nLimits: everything is read-only. Handler can't edit or delete anything in your account and never spends credits. Media files are not returned, only covers and links back to Handler.",
        "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",
          "Search your Handler research library and saved collections",
          "List your AI creators and check render status",
          "Show results as visual cards with links 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",
          "Search my Handler library for language apps and explain the best one"
        ],
        "brandColor": "#FF5733",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List the operator's brands",
              "prompt": "List my Handler brands.",
              "tools_triggered": "list_brands",
              "expected_behavior": "Returns each brand's name, niche and id from the test account."
            },
            {
              "description": "Find slideshow winners across every industry",
              "prompt": "Show me the top 3 outlier TikToks across every industry, slideshows only.",
              "tools_triggered": "find_winners",
              "expected_behavior": "Returns 3 slideshow posts with outlier multiple, Pull score, views, a one-line hook and Handler + TikTok links, shown as a visual card grid."
            },
            {
              "description": "Find niche-matched winners for a brand",
              "prompt": "Find the winning TikToks for my first brand's niche.",
              "tools_triggered": "list_brands, find_winners",
              "expected_behavior": "Gets the brand id, then returns winners matched to that brand's niche as cards."
            },
            {
              "description": "Search the library and explain a post",
              "prompt": "Search my Handler library for language apps and explain why the top result worked.",
              "tools_triggered": "search_library, explain_post",
              "expected_behavior": "Returns matching posts, then the top post's brief (what it is, why it works, product promoted) and comment analysis."
            },
            {
              "description": "Creators and render status",
              "prompt": "List my AI creators, tell me about the first one, and say whether anything is rendering.",
              "tools_triggered": "list_creators, get_creator, list_generations",
              "expected_behavior": "Returns the creator roster (including presets), one creator's profile and personality, and current render status."
            }
          ],
          "negative": [
            {
              "description": "Destructive request on a read-only connector",
              "prompt": "Delete all my saved posts in Handler."
            },
            {
              "description": "Generation request the connector cannot do",
              "prompt": "Make me a new AI creator and render a TikTok video with her."
            },
            {
              "description": "Unrelated financial action",
              "prompt": "Buy more Handler credits with my card."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Handler's connector does not sell products or process payments. It only reads the user's Handler research data.",
        "demo_recording_url": "https://gethandler.ai/review/handler-demo.mp4"
      },
      "publication": {
        "release_notes": "Initial release: find winners, explain posts, search the library, saved posts and collections, AI creators and render status. Visual card grid for winners and search results."
      },
      "apps": "./.app.json"
    }
  }
}