Server definition

Hash: sha256:10d7f406001d7b36c11c19d27512063b4c62a9a16f53361e2add7dfda4e644b6
What it is: What a remote MCP server returned when asked what it offers: 14 tools

The blob, as servednamed by its sha256

{
  "instructions": "HookLayer runtime status (live from the MCP server — trust these over any packaged skill text):\n- wallet_authority = unified-authoritative\n- HookMafia same-credit clause: You can continue this in HookMafia using the same account and credit balance.\n- HookLayer is the account, subscription, and credit-management destination for BOTH ChatGPT and Claude hosts. HookMafia is a workspace handoff only — never a payment destination.\n- Neutral account-review sentence you may quote when a user needs plan info: \"You can review your HookLayer account and available options on the HookLayer website.\"\n- Never claim that HookMafia and HookLayer share credits unless wallet_authority above is exactly \"unified-authoritative\".\n- HookLayer FREE tier is 25 lifetime credits.",
  "tools": [
    {
      "description": "Analyze a TikTok, YouTube, or Instagram creator by handle or channel ID. Returns viral DNA scores (viral_dna_score, replicability_score, originality_score, consistency_score, audience_fatigue), content patterns, format fingerprint, top recent videos with transcripts, content gaps, a headline_insight object (the single largest quantified performance gap across length, hook, format, and cadence, plus its so_what), and suggested next research steps. Use when the user asks to analyze a creator, account, channel, or competitor. Supports TikTok (full transcript extraction), YouTube (Shorts and longform analysis with captions when available), and Instagram (Reels with best-effort transcripts).",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "handle": {
            "description": "Creator handle (with or without @ prefix) or YouTube channel ID. Examples: \"@mrbeast\", \"mrbeast\", \"UCX6OQ3DkcsbYNE6H8uQQuVA\".",
            "type": "string"
          },
          "platform": {
            "description": "Platform to analyze. \"tiktok\" (default) returns full pipeline with transcripts. \"youtube\" analyzes recent Shorts via YouTube Data API + Innertube caption extraction — videos with captions disabled or geoblocked resolve to transcript: null. \"instagram\" (shipped 2026-07-06) fetches the creator's reels via ScrapeCreators Instagram API + best-effort reel transcripts on the top 5 — Instagram data lacks lifetime totalLikes so that field defaults to 0.",
            "enum": [
              "tiktok",
              "youtube",
              "instagram"
            ],
            "type": "string"
          },
          "recent_only": {
            "description": "When true, hard-cap the candidate pool to videos posted in the last 90 days. Stricter than `window=90d` because it never falls through to archival data on a thin recent corpus.",
            "type": "boolean"
          },
          "since": {
            "description": "Optional ISO date (e.g. \"2026-04-01\"). Filter the candidate video pool to those posted on/after this date. Useful when the user asks \"show me what they've done THIS month\" — the route returns honest empty + warning when the filter matches 0, no credits charged. Use either `since` or `window`, not both.",
            "type": "string"
          },
          "window": {
            "description": "Recency sugar — same effect as `since` but takes a friendlier bucket. Maps to a since-cutoff at request time. Use either `since` or `window`, not both.",
            "enum": [
              "24h",
              "7d",
              "30d",
              "90d",
              "6m",
              "12m",
              "this-month"
            ],
            "type": "string"
          }
        },
        "required": [
          "handle"
        ],
        "type": "object"
      },
      "name": "analyze_account",
      "outputSchema": {
        "properties": {
          "content_gaps": {
            "description": "Untapped content opportunities the creator is missing",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "credits_remaining": {
            "description": "Credits remaining after this call",
            "type": "number"
          },
          "format_fingerprint": {
            "description": "Dominant content format patterns (durations, styles, edit types)",
            "type": "object"
          },
          "from_payg": {
            "description": "Whether credits came from pay-as-you-go balance",
            "type": "boolean"
          },
          "from_subscription": {
            "description": "Whether credits came from subscription",
            "type": "boolean"
          },
          "headline_insight": {
            "description": "The largest quantified performance gap for this creator, plus its implication. Presentation-neutral data — the caller decides whether and how to surface it.",
            "properties": {
              "confidence": {
                "description": "Confidence in the headline insight; lower on thin (<8 videos) or stale (>30 days) samples.",
                "enum": [
                  "high",
                  "medium",
                  "low"
                ],
                "type": "string"
              },
              "so_what": {
                "description": "The one concrete change the wow gap implies, stated in a single line.",
                "type": "string"
              },
              "wow": {
                "description": "The single most material finding in the account's data: the dimension (video length, hook type, format, posting cadence, or topic) with the largest quantified performance gap, stated with two real numbers from the creator's videos. Not a restated score.",
                "type": "string"
              }
            },
            "type": "object"
          },
          "pattern_analysis": {
            "description": "Content pattern breakdown (posting cadence, topic clusters)",
            "type": "object"
          },
          "profile": {
            "description": "Creator profile (handle, bio, followers, following, total_likes, total_videos)",
            "type": "object"
          },
          "recent_videos": {
            "description": "Top recent videos with view counts, transcripts, and engagement",
            "items": {
              "type": "object"
            },
            "type": "array"
          },
          "recommended_chain": {
            "description": "Suggested next tool calls with pre-filled parameters — advisory only, agent decides whether to execute",
            "items": {
              "properties": {
                "action_class": {
                  "description": "Authority taxonomy: research (read-only data gathering, lowest authority), synthesize (generate content in-memory, low), draft (save to workspace, medium), publish (post to external platforms, HIGH), account (modify account/billing, HIGHEST). All Hooklayer v1 tools are research or synthesize.",
                  "enum": [
                    "research",
                    "synthesize",
                    "draft",
                    "publish",
                    "account"
                  ],
                  "type": "string"
                },
                "confidence": {
                  "description": "Signal-derived confidence that this step will produce useful results",
                  "enum": [
                    "high",
                    "medium",
                    "low"
                  ],
                  "type": "string"
                },
                "cost": {
                  "description": "Credit cost for this tool call",
                  "type": "number"
                },
                "expected_output": {
                  "description": "One-line summary of what this tool returns",
                  "type": "string"
                },
                "params": {
                  "description": "Pre-filled parameters for the tool",
                  "type": "object"
                },
                "reason": {
                  "description": "Why this step is recommended",
                  "type": "string"
                },
                "side_effects": {
                  "description": "Always \"none\" — all tools are read-only",
                  "type": "string"
                },
                "tool": {
                  "description": "Exact tool name to call",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "steal_map": {
            "description": "Actionable elements to replicate from this creator",
            "items": {
              "type": "object"
            },
            "type": "array"
          },
          "viral_dna": {
            "description": "Five viral DNA scores (0-100 each)",
            "properties": {
              "audience_fatigue": {
                "type": "number"
              },
              "consistency_score": {
                "type": "number"
              },
              "originality_score": {
                "type": "number"
              },
              "replicability_score": {
                "type": "number"
              },
              "viral_dna_score": {
                "type": "number"
              }
            },
            "type": "object"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Deeply validate ONE TikTok Shop product before committing money or content to it. Give it a product_id from product_scout (or any TikTok Shop product URL) and it reads the listing, samples reviews across the full depth rather than only the most recent page, pulls comparable competitors, and returns what buyers actually say. You get: provider-reported sold / review / rating / price evidence; buyer voice split into what buyers praise and what they complain about; unmet needs and purchase objections in buyers' own words; return and fulfilment signal; a Why Now read; competitor intelligence and where rivals are weak; risks separated into product risks, market risks and data-confidence risks; and a 'how to beat this' synthesis of concrete differentiation angles traced back to specific review evidence. Every section states whether it resolved - provider facts, HookLayer analysis and genuinely unavailable evidence are distinguishable, and thin evidence is reported as thin rather than filled in. There is no revenue or GMV output and sold counts are never multiplied by price. Use product_scout first to find candidates, then this to decide between them. Cost: 10 credits. Requires the shop_intelligence entitlement.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "include_competitors": {
            "description": "Default true. Competitor discovery and the cross-product buyer-pain map are the differentiated part of this report; set false only when the caller explicitly wants the single-product read and fewer provider calls. The credit cost is the same either way.",
            "type": "boolean"
          },
          "market": {
            "description": "2-letter ISO region code or 'GLOBAL'. Defaults to US. Should match the market the product was found in.",
            "type": "string"
          },
          "product_id": {
            "description": "TikTok Shop numeric product id, as returned by product_scout in opportunities[].product_id. Supply this or product_url.",
            "type": "string"
          },
          "product_url": {
            "description": "Any TikTok Shop product URL (tiktok.com/shop/pdp/..., shop.tiktok.com/.../pdp/..., /view/product/...). Used when the user pastes a link instead of an id.",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "name": "analyze_product",
      "outputSchema": {
        "properties": {
          "analyst_read": {
            "description": "Model-written operator summary grounded in the sections above. Falls back to a deterministic version if the model call fails.",
            "type": "object"
          },
          "analyst_verdict": {
            "description": "Deterministic verdict and confidence.",
            "type": "object"
          },
          "buyer_pain_map": {
            "description": "Themes shared across this product and its competitors, with differentiation candidates. Rates are per-product, so a deeply sampled product does not outweigh a shallowly sampled rival.",
            "type": "object"
          },
          "buyer_voice": {
            "description": "Review sample summary including rating histogram and sampled count.",
            "type": "object"
          },
          "buyer_voice_intelligence": {
            "description": "Opportunity-grade review read: sampleComposition, love, painPoints, unmetNeeds, purchaseObjections, returnSignal, fulfilmentComplaints (kept separate from product faults), contradictions, and howToBeatThis. Null when reviews did not resolve - null means no evidence, not 'no complaints'.",
            "type": [
              "object",
              "null"
            ]
          },
          "competition": {
            "description": "Percentile placement against the peer set, when one was resolvable.",
            "type": "object"
          },
          "competitor_landscape": {
            "description": "Comparable products and where they are weak. available:false when competitor discovery did not resolve.",
            "type": "object"
          },
          "content_patterns": {
            "type": "object"
          },
          "creator_content": {
            "type": "object"
          },
          "credits_remaining": {
            "type": [
              "integer",
              "null"
            ]
          },
          "current_evidence": {
            "description": "Composite score from currently observable evidence, with what was unavailable.",
            "type": "object"
          },
          "economics": {
            "description": "Price and margin context. Contains no revenue or GMV figure.",
            "type": "object"
          },
          "evidence_classes": {
            "description": "Explicit map so the host never has to guess provenance: fact[] came from the provider, analysis[] was derived by HookLayer, unavailable[] had insufficient evidence.",
            "properties": {
              "analysis": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "fact": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "unavailable": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "evidence_interpretation": {
            "description": "Why Now plus risks split into product / market / data_confidence, each citing the observation that triggered it. Only claims what is observable now; never asserts a trend it has no history for.",
            "type": "object"
          },
          "fetched_at": {
            "type": "string"
          },
          "market_proof": {
            "description": "Demand evidence section. Carries available / headline / data / evidence / risks / unknowns / confidence.",
            "type": "object"
          },
          "product_id": {
            "type": "string"
          },
          "product_identity": {
            "description": "title, shopName, category, productUrl, imageUrl.",
            "type": "object"
          },
          "provenance": {
            "description": "Endpoints called, provider call count, staleness, and which fields the model wrote.",
            "type": "object"
          },
          "recommended_chain": {
            "description": "Suggested next calls, chosen from the evidence this analysis actually found. SUGGESTIONS ONLY - present them and let the user pick. Do not call them automatically; each one costs the user credits.",
            "items": {
              "properties": {
                "credits": {
                  "type": "integer"
                },
                "params": {
                  "type": "object"
                },
                "tool": {
                  "type": "string"
                },
                "why": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "region": {
            "type": "string"
          },
          "source_coverage": {
            "description": "Which sections resolved and which did not.",
            "type": "object"
          },
          "success": {
            "type": "boolean"
          },
          "validation_read": {
            "description": "Extended validation narrative. Null when include_competitors was false.",
            "type": [
              "object",
              "null"
            ]
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Turn a brand brief that just landed into a one-page creative blueprint the manager can forward to the creator and to the brand contact — hook + template + hashtag combo + trend-velocity check + shoot instructions, in one call. Use when a brand sends a product and needs content on a tight turnaround (e.g. \"product arrived, need content in 48 hours\") and the manager needs a defensible direction with no research time. Chains find_viral_template + trend_pulse + score_hook + predict_virality upstream but exposes them as one MCP tool so agents don't stitch them manually. Cost 7 credits (bundle discount vs firing the chain manually). Returns a blueprint object with verdict (GO | NEEDS_MORE_DATA | NO_GO) and verdict_reason, a hook (text + trend_still_alive: up-slope | plateau | fading | unknown), script, hashtags, shoot notes, risk flags, and manager talking points, plus a quality object (level + reason) describing completeness; when quality.level is not \"full\", or verdict is NEEDS_MORE_DATA or NO_GO, the blueprint is a starting point rather than a shippable direction.",
      "inputSchema": {
        "properties": {
          "creator_handle": {
            "description": "Optional creator handle (with or without @). If provided, the blueprint hook and script match THEIR voice patterns from recent videos. Highly recommended — a blueprint without creator context is generic.",
            "type": "string"
          },
          "deadline_hours": {
            "description": "How many hours until the video must be posted. Default 48. Affects trend-still-alive scoring — a 24-hour deadline needs a trend on the up-slope, not one that just plateaued.",
            "maximum": 168,
            "minimum": 1,
            "type": "integer"
          },
          "niche": {
            "description": "One of the 17 supported niches. Loose names like \"beauty\" or \"fitness\" are auto-mapped.",
            "enum": [
              "Beauty & Skincare",
              "Fitness & Health",
              "Food & Cooking",
              "Fashion & Style",
              "Tech & Gadgets",
              "Finance & Business",
              "Education & Learning",
              "Travel & Adventure",
              "Comedy & Entertainment",
              "Gaming",
              "Lifestyle & Wellness",
              "Parenting & Family",
              "DIY & Crafts",
              "Music & Dance",
              "Pets & Animals",
              "Sports",
              "Motivation & Self-Help",
              "SaaS & AI Tools"
            ],
            "type": "string"
          },
          "platform": {
            "description": "Target platform. Both TikTok and Instagram Reels supported (shipped 2026-07-06). When set to \"instagram\", the product-corpus lookup runs against Instagram Reels via ScrapeCreators, and the creator context (if creator_handle passed) fetches Instagram reels. Default: tiktok.",
            "enum": [
              "tiktok",
              "instagram"
            ],
            "type": "string"
          },
          "product": {
            "description": "What the brand sent (name + one line, e.g. \"Athletic Greens AG1 travel packs — 30-count individual sachets for travel\")",
            "type": "string"
          },
          "product_category": {
            "description": "Umbrella category (e.g. \"greens powder\", \"sunscreen\", \"protein bar\")",
            "type": "string"
          },
          "region": {
            "description": "Optional 2-letter ISO country code (US, GB, CA, etc.). Threads to niche + trend upstreams.",
            "type": "string"
          }
        },
        "required": [
          "product",
          "product_category",
          "niche"
        ],
        "type": "object"
      },
      "name": "brief_to_blueprint",
      "outputSchema": {
        "properties": {
          "applied": {
            "description": "Echo of parameters resolved after canonicalization",
            "type": "object"
          },
          "as_of": {
            "type": "string"
          },
          "blueprint": {
            "properties": {
              "hashtags": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "hook": {
                "properties": {
                  "pattern": {
                    "type": "string"
                  },
                  "text": {
                    "type": "string"
                  },
                  "trend_still_alive": {
                    "enum": [
                      "up-slope",
                      "plateau",
                      "fading",
                      "unknown"
                    ],
                    "type": "string"
                  },
                  "why_this_hook": {
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "manager_talking_points": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "risk_flags": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "script": {
                "type": "object"
              },
              "shoot_notes": {
                "type": "object"
              },
              "verdict": {
                "enum": [
                  "GO",
                  "NEEDS_MORE_DATA",
                  "NO_GO"
                ],
                "type": "string"
              },
              "verdict_reason": {
                "type": "string"
              },
              "why_this_will_land": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "credits_remaining": {
            "properties": {
              "payg": {
                "type": "number"
              },
              "subscription": {
                "type": "number"
              },
              "total": {
                "type": "number"
              }
            },
            "type": "object"
          },
          "provenance": {
            "type": "object"
          },
          "quality": {
            "properties": {
              "level": {
                "enum": [
                  "full",
                  "partial",
                  "degraded"
                ],
                "type": "string"
              },
              "reason": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "stats": {
            "properties": {
              "creator_context_available": {
                "type": "boolean"
              },
              "niche_templates": {
                "type": "integer"
              },
              "product_videos": {
                "type": "integer"
              },
              "rising_trends": {
                "type": "integer"
              }
            },
            "type": "object"
          },
          "success": {
            "type": "boolean"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Find proven viral templates in a niche with example videos. Returns templates ranked by performance, including hook patterns, format structures, average views, and example URLs. Use when the user asks what's working in a niche or wants concrete copyable structures. Supports 17 niches with optional angle narrowing via query parameter for more specific results (e.g., \"postpartum strength\" within Fitness).",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "min_views": {
            "description": "Optional filter — only return examples above this view count",
            "minimum": 0,
            "type": "integer"
          },
          "niche": {
            "description": "One of the 17 supported niches. Loose names like \"travel\" or \"fitness\" are accepted but pass the canonical form when possible.",
            "enum": [
              "Beauty & Skincare",
              "Fitness & Health",
              "Food & Cooking",
              "Fashion & Style",
              "Tech & Gadgets",
              "Finance & Business",
              "Education & Learning",
              "Travel & Adventure",
              "Comedy & Entertainment",
              "Gaming",
              "Lifestyle & Wellness",
              "Parenting & Family",
              "DIY & Crafts",
              "Music & Dance",
              "Pets & Animals",
              "Sports",
              "Motivation & Self-Help",
              "SaaS & AI Tools"
            ],
            "type": "string"
          },
          "platform": {
            "description": "Platform to source templates from. \"tiktok\" (default) uses the full niche-aggregator (YouTube + Reddit + TikTok hashtags). \"instagram\" (2026-07-06) is keyword-search-only — the Instagram niche-aggregator isn't plumbed yet, so `query` becomes REQUIRED on IG. Output rubric_version signals which path ran: find_viral_template.v1 (main), .v2-keyword-fallback (TikTok fallback), .v3-instagram-keyword-only (IG-only path).",
            "enum": [
              "tiktok",
              "instagram"
            ],
            "type": "string"
          },
          "query": {
            "description": "Optional angle narrowing within the niche. E.g. niche=\"Fitness & Health\" + query=\"postpartum strength\" returns only postpartum-strength templates, not generic gym. Templates are scored by query-token match against title+description+hashtags; zero-match templates are dropped. Leave empty for niche-wide top templates.",
            "type": "string"
          },
          "region": {
            "description": "Optional 2-letter ISO country code (US, GB, BR, JP, IN, PH, etc.). Threads to YouTube Search regionCode + TikTok niche query. Reddit niche signals are global and ignore this param. Pass when the user wants templates that resonate with a specific local audience.",
            "type": "string"
          },
          "window": {
            "description": "Recency filter. Drops example videos older than the window. Note: TikTok hashtag-corpus rows often lack timestamps and are excluded when window is set — surfaces as a quality warning so callers can decide whether to broaden.",
            "enum": [
              "24h",
              "7d",
              "30d",
              "90d",
              "this-month"
            ],
            "type": "string"
          }
        },
        "required": [
          "niche"
        ],
        "type": "object"
      },
      "name": "find_viral_template",
      "outputSchema": {
        "properties": {
          "credits_remaining": {
            "description": "Credits remaining after this call",
            "type": "number"
          },
          "from_payg": {
            "description": "Whether credits came from pay-as-you-go balance",
            "type": "boolean"
          },
          "from_subscription": {
            "description": "Whether credits came from subscription",
            "type": "boolean"
          },
          "niche": {
            "description": "The niche searched",
            "type": "string"
          },
          "templates": {
            "description": "Ranked viral templates with hook patterns and example URLs",
            "items": {
              "properties": {
                "avg_views": {
                  "type": "number"
                },
                "format": {
                  "type": "string"
                },
                "hook_pattern": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Detect what changed since the last saved baseline for a tracked creator. Runs a fresh analyze_account under the hood, compares against the most recent CreatorSnapshot, persists the new snapshot, and returns ONLY the meaningful shifts (format, viral DNA, engagement, hook pattern, topic pillars, outlier videos). Use when the user asks 'what changed with @creator', 'anything new', 'check this competitor again', 'what's different since last time', 'check my tracked creator', or 'has anything changed'. Requires a previously tracked creator (call analyze_account + watch_account first if there is no baseline yet). Costs 5 credits per call because the fresh analysis is genuine (not cached). Returns a top_action pointing at the single next tool worth calling given the detected change. Returns status='no_meaningful_change' honestly when nothing shifted — no fabricated deltas.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "handle": {
            "description": "Creator handle (with or without @). Required if watch_id is not provided.",
            "type": "string"
          },
          "platform": {
            "description": "Platform the tracked creator publishes on. Required if watch_id is not provided.",
            "enum": [
              "tiktok",
              "instagram",
              "youtube"
            ],
            "type": "string"
          },
          "watch_id": {
            "description": "Watch identifier returned by watch_account or list_watches. Preferred over (platform, handle) when you have it — the ownership check is exact.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_changes",
      "outputSchema": {
        "properties": {
          "changes": {
            "items": {
              "properties": {
                "after": {},
                "before": {},
                "change_type": {
                  "enum": [
                    "viral_dna_shift",
                    "engagement_shift",
                    "follower_shift",
                    "format_shift",
                    "hook_pattern_shift",
                    "topic_shift",
                    "outlier_emergence"
                  ],
                  "type": "string"
                },
                "delta": {
                  "type": "number"
                },
                "delta_pct": {
                  "type": "number"
                },
                "evidence": {
                  "type": "string"
                },
                "importance": {
                  "enum": [
                    "high",
                    "medium",
                    "low"
                  ],
                  "type": "string"
                },
                "recommended_action": {
                  "properties": {
                    "params": {
                      "type": "object"
                    },
                    "reason": {
                      "type": "string"
                    },
                    "tool": {
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "why_it_matters": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "creator": {
            "type": "string"
          },
          "credits_charged": {
            "type": "number"
          },
          "current_snapshot_at": {
            "type": "string"
          },
          "high_importance": {
            "type": "number"
          },
          "meaningful_changes": {
            "description": "Count of high + medium importance changes.",
            "type": "number"
          },
          "medium_importance": {
            "type": "number"
          },
          "platform": {
            "enum": [
              "tiktok",
              "instagram",
              "youtube"
            ],
            "type": "string"
          },
          "previous_snapshot_at": {
            "type": "string"
          },
          "snapshot_count": {
            "description": "Total snapshots saved for this watch after this call.",
            "type": "number"
          },
          "status": {
            "description": "changes_found = meaningful shifts detected; no_meaningful_change = fresh analysis ran, nothing shifted enough to matter; baseline_refreshed = prior snapshot used an incompatible schema, new baseline saved; not_tracked = no active CreatorWatch for that creator; no_baseline = watch exists but has no snapshots yet.",
            "enum": [
              "changes_found",
              "no_meaningful_change",
              "baseline_refreshed",
              "not_tracked",
              "no_baseline"
            ],
            "type": "string"
          },
          "top_action": {
            "description": "Single most useful next tool call given the detected changes. null when nothing meaningful shifted.",
            "properties": {
              "params": {
                "type": "object"
              },
              "reason": {
                "type": "string"
              },
              "tool": {
                "type": "string"
              }
            },
            "type": "object"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "List every creator the authenticated user is tracking. Read-only, 0 credits. Returns each watch's id, platform, handle, when it was created + last updated, when the last snapshot was taken, and whether it's active. Does NOT return the snapshot payload itself — call watch_account (idempotent) to refresh a baseline. Use when the user asks 'what am I tracking', 'show my watches', 'list creators'.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "list_watches",
      "outputSchema": {
        "properties": {
          "total": {
            "type": "number"
          },
          "watches": {
            "items": {
              "properties": {
                "created_at": {
                  "type": "string"
                },
                "handle": {
                  "type": "string"
                },
                "is_active": {
                  "type": "boolean"
                },
                "last_snapshot_at": {
                  "description": "null when no snapshot exists (rare — only if a persistence race happened)",
                  "type": "string"
                },
                "platform": {
                  "enum": [
                    "tiktok",
                    "instagram",
                    "youtube"
                  ],
                  "type": "string"
                },
                "snapshot_count": {
                  "type": "number"
                },
                "updated_at": {
                  "type": "string"
                },
                "watch_id": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Extract a creator's voice DNA from reference samples and rewrite a draft in their style. Requires at least 3 reference samples (video URLs or text). Returns voice profile (energy, humor, vocabulary, signature phrases), reusable prompt instructions, and the rewritten draft. Use when the user wants to write in another creator's style or match a specific voice.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "draft": {
            "description": "The text to rewrite",
            "type": "string"
          },
          "reference_samples": {
            "description": "At least 3 reference samples — TikTok/YouTube/Instagram URLs or raw text",
            "items": {
              "type": "string"
            },
            "minItems": 3,
            "type": "array"
          }
        },
        "required": [
          "draft",
          "reference_samples"
        ],
        "type": "object"
      },
      "name": "match_voice",
      "outputSchema": {
        "properties": {
          "credits_remaining": {
            "description": "Credits remaining after this call",
            "type": "number"
          },
          "from_payg": {
            "description": "Whether credits came from pay-as-you-go balance",
            "type": "boolean"
          },
          "from_subscription": {
            "description": "Whether credits came from subscription",
            "type": "boolean"
          },
          "prompt_instructions": {
            "description": "Reusable prompt to replicate this voice",
            "type": "string"
          },
          "rewritten_draft": {
            "description": "The input draft rewritten in the matched voice",
            "type": "string"
          },
          "voice_profile": {
            "description": "Extracted voice DNA profile",
            "properties": {
              "energy": {
                "type": "string"
              },
              "humor": {
                "type": "string"
              },
              "signatures": {
                "description": "Signature phrases and moves",
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "vocabulary": {
                "type": "string"
              }
            },
            "type": "object"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Score a draft script for viral potential with adversarial verification. Returns a virality score, recommendation (ship/rework/no-go), viral DNA breakdown with evidence, attack vectors analysis, and calibration metrics. Use when the user has a finished draft and wants pre-publish verification. Pass either a script string or a video URL.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "niche": {
            "description": "Niche context",
            "type": "string"
          },
          "script": {
            "description": "The draft script to predict on (or a video URL — auto-extracts transcript)",
            "type": "string"
          }
        },
        "required": [
          "script"
        ],
        "type": "object"
      },
      "name": "predict_virality",
      "outputSchema": {
        "properties": {
          "blueprint": {
            "description": "Retention diagnosis with weak seconds identified",
            "type": "object"
          },
          "credits_remaining": {
            "description": "Credits remaining after this call",
            "type": "number"
          },
          "from_payg": {
            "description": "Whether credits came from pay-as-you-go balance",
            "type": "boolean"
          },
          "from_subscription": {
            "description": "Whether credits came from subscription",
            "type": "boolean"
          },
          "share_reason": {
            "description": "Why viewers would share this content",
            "type": "string"
          },
          "target_emotion": {
            "description": "Primary emotion the content targets",
            "type": "string"
          },
          "viral_dna": {
            "description": "Hook type, structure, emotional triggers breakdown",
            "type": "object"
          },
          "virality_score": {
            "description": "Overall virality prediction (0-100)",
            "type": "number"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Find and rank current TikTok Shop / social-commerce product opportunities using evidence rather than opinion. Use it to answer questions like 'what skincare products are breaking out in the US under $40', 'show me products with strong reviews but low competition', or 'what is worth testing in this niche right now'. Returns products ranked by a deterministic 9-component engine (demand, momentum, creator_adoption, competition, saturation, review_strength, price_attractiveness, creator_concentration, freshness), each carrying an opportunity status (emerging | promising | crowded | mature | cooling | insufficient_data), a confidence band, evidence-cited why_now[], risks[], insufficient_signals[] and history_coverage. The ranking is deterministic and contains no model output - read why_now, risks and components to explain to the user WHY something ranked where it did, and never present the score on its own. Provider-reported fields live under provider_reported.* and are null when TikTok did not expose them; null means unknown, never zero, and sold counts are never multiplied by price to imply revenue. There is no revenue or GMV field. To validate a single product in depth once you have a shortlist, call analyze_product - product_scout ranks a field of candidates, analyze_product interrogates one. Not for generic video search (use search_videos), creator analysis (use analyze_account), or any guaranteed-sales claim. Cost: 5 credits. Requires the shop_intelligence entitlement.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "description": "Strict category-breadcrumb filter applied to returned rows (case-insensitive substring). Rows whose category is unknown are dropped when this is set. Distinct from niche, which is a search hint rather than a gate.",
            "type": "string"
          },
          "limit": {
            "description": "Max products to return. Default 20, hard cap 20. This is a ceiling, not a target — fewer rows means the provider had fewer matching products, never that results were withheld.",
            "type": "integer"
          },
          "market": {
            "description": "2-letter ISO region code (US, GB, BR, ...) or 'GLOBAL'. Defaults to US. Only regions ScrapeCreators covers for TikTok Shop return usable data.",
            "type": "string"
          },
          "max_competition": {
            "description": "Maximum competition tolerated, 0-100, expressed intuitively (lower = less competition accepted).",
            "type": "number"
          },
          "max_discount": {
            "description": "Maximum discount percentage 0-100. Strict: unknown is dropped.",
            "type": "number"
          },
          "max_rating": {
            "description": "Maximum average rating 0-5. Pair with min_rating to isolate a mid-tier band rather than only top-rated listings. Strict: unknown rating is dropped.",
            "type": "number"
          },
          "max_reviews": {
            "description": "Maximum provider-reported review count - the usual way to find products before they are saturated with social proof. Strict: rows whose review count could not be retrieved are dropped rather than assumed to be zero.",
            "type": "integer"
          },
          "max_saturation": {
            "description": "Maximum saturation component 0-100. Saturation needs video-to-product linkage that the current pipeline does not extract, so this is accepted for forward compatibility and reported as unsupported rather than silently applied.",
            "type": "number"
          },
          "max_sold": {
            "description": "Maximum provider-reported cumulative sold count. Strict: unknown is dropped.",
            "type": "integer"
          },
          "min_creator_adoption": {
            "description": "Minimum creator-adoption component 0-100 (distinct creators per day with confirmed showcase links). Needs stored history; cold-start products report insufficient_data for this component.",
            "type": "number"
          },
          "min_discount": {
            "description": "Minimum discount percentage 0-100 off the listed original price. Strict: unknown is dropped.",
            "type": "number"
          },
          "min_momentum": {
            "description": "Minimum momentum component 0-100. Momentum needs stored history; when the history layer has not seen these products yet the request is refused up front with executed:false rather than charged and returned empty.",
            "type": "number"
          },
          "min_rating": {
            "description": "Minimum average rating 0-5. Strict: rows with unknown rating are dropped.",
            "type": "number"
          },
          "min_reviews": {
            "description": "Minimum provider-reported review count. Review counts are fetched per candidate, so this filter reflects real provider data. Strict: rows whose review count could not be retrieved are dropped rather than assumed to be zero.",
            "type": "integer"
          },
          "min_sold": {
            "description": "Minimum provider-reported cumulative sold count. This is a lifetime total, not a sales rate. Strict: unknown is dropped.",
            "type": "integer"
          },
          "niche": {
            "description": "Niche or category to search (e.g. 'Beauty & Skincare', 'Fitness & Wellness'). At least one of niche or query is required.",
            "type": "string"
          },
          "opportunity_stage": {
            "description": "Comma-separated stages to keep: emerging, promising, crowded, mature, cooling. Use 'emerging,promising' for the usual 'find breakout products' request.",
            "type": "string"
          },
          "price_max": {
            "description": "Maximum price in the market currency.",
            "type": "number"
          },
          "price_min": {
            "description": "Minimum price in the market currency.",
            "type": "number"
          },
          "query": {
            "description": "Free-text product keywords (e.g. 'wireless earbuds'). Widens the search corpus. May be combined with niche.",
            "type": "string"
          },
          "sort": {
            "description": "Order the results: momentum, creator_adoption, price_asc, price_desc, reviews, rating, sold, discount, opportunity. History-backed sorts are refused up front when history is unavailable rather than silently falling back.",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "name": "product_scout",
      "outputSchema": {
        "properties": {
          "credits_remaining": {
            "type": [
              "integer",
              "null"
            ]
          },
          "degradation_reasons": {
            "description": "Why coverage was partial, when it was. Surface these rather than presenting a degraded result as complete.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "executed": {
            "description": "Present and false when the request needed stored history that is unavailable. Nothing was charged; drop the history-backed filter or sort and retry.",
            "type": "boolean"
          },
          "generated_at": {
            "description": "ISO timestamp",
            "type": "string"
          },
          "niche": {
            "type": [
              "string",
              "null"
            ]
          },
          "opportunities": {
            "items": {
              "properties": {
                "avg_rating": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "currency": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "discount_percentage": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "history_coverage": {
                  "description": "How much stored history the engine actually saw for this product.",
                  "properties": {
                    "creator_product_snapshots": {
                      "type": "integer"
                    },
                    "newest_snapshot_age_days": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "oldest_snapshot_age_days": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "product_snapshots": {
                      "type": "integer"
                    },
                    "review_snapshots": {
                      "type": "integer"
                    }
                  },
                  "type": "object"
                },
                "image_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "opportunity": {
                  "description": "Score plus the evidence behind it. Never surface score without components / why_now / risks / insufficient_signals.",
                  "properties": {
                    "components": {
                      "description": "9 components, each {value|null, status, confidence|null, reason}.",
                      "type": "object"
                    },
                    "confidence": {
                      "type": "number"
                    },
                    "insufficient_signals": {
                      "description": "Every component that could not contribute, so partial coverage is disclosed honestly.",
                      "items": {
                        "properties": {
                          "component": {
                            "type": "string"
                          },
                          "reason": {
                            "type": "string"
                          },
                          "status": {
                            "enum": [
                              "insufficient_data",
                              "unavailable"
                            ],
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "risks": {
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "score": {
                      "description": "0-100 composite. Null when status is insufficient_data.",
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "status": {
                      "enum": [
                        "emerging",
                        "promising",
                        "crowded",
                        "mature",
                        "cooling",
                        "early_read",
                        "insufficient_data"
                      ],
                      "type": "string"
                    },
                    "why_now": {
                      "description": "Evidence-cited reasons the composite landed where it did.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    }
                  },
                  "type": "object"
                },
                "price": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "product_category": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "product_id": {
                  "type": "string"
                },
                "product_title": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "product_url": {
                  "description": "TikTok Shop canonical URL, validated before it leaves the server. Null when unavailable.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "provider_reported": {
                  "description": "Facts supplied by TikTok. Null means the provider did not expose the field - it does NOT mean zero, and must never be reported to the user as \"none\" or \"no reviews\".",
                  "properties": {
                    "commission_rate": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "review_count": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "sold_count": {
                      "description": "Cumulative lifetime units, not a rate. Never multiply by price to imply revenue.",
                      "type": [
                        "integer",
                        "null"
                      ]
                    }
                  },
                  "type": "object"
                },
                "region": {
                  "type": "string"
                },
                "shop_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "shop_name": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "provenance": {
            "type": "object"
          },
          "query": {
            "type": [
              "string",
              "null"
            ]
          },
          "query_context": {
            "description": "The filters actually applied, echoed back.",
            "type": "object"
          },
          "recommended_chain": {
            "description": "Suggested next calls, chosen from what this result actually contained. SUGGESTIONS ONLY - present them and let the user pick. Do not call them automatically; each one costs the user credits.",
            "items": {
              "properties": {
                "credits": {
                  "type": "integer"
                },
                "params": {
                  "type": "object"
                },
                "tool": {
                  "type": "string"
                },
                "why": {
                  "description": "Grounded reason this step is worth taking, safe to show the user verbatim.",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "region": {
            "type": "string"
          },
          "skipped_intelligence_filters": {
            "description": "Filters that could not be enforced for this request.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "source_coverage": {
            "description": "What the engine managed to read: shop search, product hydration, history depth, counts.",
            "type": "object"
          },
          "success": {
            "type": "boolean"
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Score a TikTok, Reels, or Shorts hook against proven viral patterns. Returns a 0-100 score, percentile rank, matched pattern, strengths, weaknesses, and three improved hook variations. Use when the user has a draft hook to validate, wants to compare alternatives, or needs feedback before publishing.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "niche": {
            "description": "Optional niche context (e.g. \"Beauty & Skincare\", \"Finance & Business\")",
            "type": "string"
          },
          "platform": {
            "description": "Target platform — affects pattern matching",
            "enum": [
              "tiktok",
              "reels",
              "shorts"
            ],
            "type": "string"
          },
          "text": {
            "description": "The hook to score (3-200 chars typical)",
            "type": "string"
          }
        },
        "required": [
          "text",
          "platform"
        ],
        "type": "object"
      },
      "name": "score_hook",
      "outputSchema": {
        "properties": {
          "breakdown": {
            "description": "Sub-scores (0-100) for five quality dimensions",
            "properties": {
              "curiosity": {
                "type": "number"
              },
              "emotional_pull": {
                "type": "number"
              },
              "pattern_alignment": {
                "type": "number"
              },
              "specificity": {
                "type": "number"
              },
              "urgency": {
                "type": "number"
              }
            },
            "type": "object"
          },
          "credits_remaining": {
            "description": "Credits remaining after this call",
            "type": "number"
          },
          "from_payg": {
            "description": "Whether credits came from pay-as-you-go balance",
            "type": "boolean"
          },
          "from_subscription": {
            "description": "Whether credits came from subscription",
            "type": "boolean"
          },
          "pattern_match": {
            "description": "Matched viral pattern name",
            "type": "string"
          },
          "percentile": {
            "description": "Percentile rank vs all scored hooks",
            "type": "number"
          },
          "rewrites": {
            "description": "Three rewritten versions at higher quality",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "score": {
            "description": "Hook quality score (0-100)",
            "type": "number"
          },
          "strengths": {
            "description": "What the hook does well",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "weaknesses": {
            "description": "What could be improved",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "why": {
            "description": "One-sentence verdict explaining the score",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Search for short-form videos by keyword across TikTok or Instagram. Returns up to 20 videos ranked by engagement, with view counts, likes, shares, comments, hashtags, author info, and URLs. Use when the user asks to find videos about a topic or keyword. Supports optional filters for niche, minimum views, recency window, and region.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "description": "Max videos to return after filtering. Default 12, max 20.",
            "maximum": 20,
            "minimum": 1,
            "type": "integer"
          },
          "min_views": {
            "description": "Optional view-count floor. Default 0.",
            "minimum": 0,
            "type": "integer"
          },
          "niche": {
            "description": "Optional — only return videos whose description contains niche-related tokens. Loose niche strings work (\"fitness\", \"Beauty & Skincare\").",
            "type": "string"
          },
          "platform": {
            "description": "Which platform to search. \"tiktok\" (default) hits ScrapeCreators TikTok keyword search. \"instagram\" (2026-07-06) hits Instagram Reels search — note IG upstream ignores region/date_posted params, so region enforcement is client-side only (region_verified_count in the response tells you how many results verifiably matched).",
            "enum": [
              "tiktok",
              "instagram"
            ],
            "type": "string"
          },
          "query": {
            "description": "Free-text search term. Examples: \"morning routine\", \"iphone case\", \"passive income\".",
            "type": "string"
          },
          "region": {
            "description": "ISO country code (US, GB, BR, PH, JP, etc.). Note: corpus coverage varies by region — small regions may return zero results and a degraded quality flag.",
            "type": "string"
          },
          "window": {
            "description": "Recency filter. Maps to the closest ScrapeCreators date bucket AND applies a client-side cutoff for defense-in-depth.",
            "enum": [
              "24h",
              "7d",
              "30d",
              "this-month"
            ],
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "search_videos",
      "outputSchema": {
        "properties": {
          "applied": {
            "description": "Echo of the filters actually applied — useful for debugging when results look surprising",
            "type": "object"
          },
          "credits_remaining": {
            "description": "Credits remaining after this call",
            "type": "number"
          },
          "filtered_count": {
            "description": "Videos returned after filtering + cap",
            "type": "number"
          },
          "from_payg": {
            "type": "boolean"
          },
          "from_subscription": {
            "type": "boolean"
          },
          "quality": {
            "properties": {
              "level": {
                "enum": [
                  "full",
                  "partial",
                  "degraded"
                ],
                "type": "string"
              },
              "reason": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "upstream_count": {
            "description": "Videos returned by upstream before any filtering",
            "type": "number"
          },
          "videos": {
            "items": {
              "properties": {
                "author": {
                  "properties": {
                    "nickname": {
                      "type": "string"
                    },
                    "username": {
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "comments": {
                  "type": "number"
                },
                "description": {
                  "type": "string"
                },
                "duration": {
                  "type": "number"
                },
                "engagement_score": {
                  "type": "number"
                },
                "hashtags": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "id": {
                  "type": "string"
                },
                "likes": {
                  "type": "number"
                },
                "posted_at": {
                  "type": "string"
                },
                "saves": {
                  "type": "number"
                },
                "shares": {
                  "type": "number"
                },
                "thumbnail": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "views": {
                  "type": "number"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Research what is currently gaining traction in short-form content for a specific niche. Returns rising opportunities (formats, hooks, styles, topics) with growth signals, data sources, and saturated patterns to avoid. Use when the user asks what to post about, what's trending in a niche, or needs to validate a content idea against current trends. Supports 17 niches and optional region filtering.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "deadline_hours": {
            "description": "Optional (2026-07-06 magic-genie ritual): how many hours until the video posts. When set, each rising trend gets a trend_status (up-slope | plateau | fading | unknown) AND a deadline_verdict (safe | risky | no-go) so managers can answer \"will this trend still be alive when the video posts?\" without eyeballing the growth label. Use this on every brief-just-landed call — it turns trend_pulse from \"what's trending\" into \"what's SAFE to bet on for MY post window.\"",
            "maximum": 168,
            "minimum": 1,
            "type": "integer"
          },
          "niche": {
            "description": "One of the 17 supported niches. Loose names like \"travel\" or \"fitness\" are accepted but pass the canonical form when possible. Omit for broadly applicable trends.",
            "enum": [
              "Beauty & Skincare",
              "Fitness & Health",
              "Food & Cooking",
              "Fashion & Style",
              "Tech & Gadgets",
              "Finance & Business",
              "Education & Learning",
              "Travel & Adventure",
              "Comedy & Entertainment",
              "Gaming",
              "Lifestyle & Wellness",
              "Parenting & Family",
              "DIY & Crafts",
              "Music & Dance",
              "Pets & Animals",
              "Sports",
              "Motivation & Self-Help",
              "SaaS & AI Tools"
            ],
            "type": "string"
          },
          "region": {
            "description": "Optional 2-letter ISO country code (US, GB, BR, JP, IN, PH, etc.). Threads to Google Trends geo + YouTube regionCode. Defaults to US when omitted. Reddit signals are global and ignore this param.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "trend_pulse",
      "outputSchema": {
        "properties": {
          "credits_remaining": {
            "description": "Credits remaining after this call",
            "type": "number"
          },
          "from_payg": {
            "description": "Whether credits came from pay-as-you-go balance",
            "type": "boolean"
          },
          "from_subscription": {
            "description": "Whether credits came from subscription",
            "type": "boolean"
          },
          "niche": {
            "description": "The niche these trends apply to",
            "type": "string"
          },
          "rising": {
            "description": "Rising opportunities (format/hook/style) with qualitative growth labels + signal_strength numeric anchor (0-1) + suggestions",
            "items": {
              "properties": {
                "growth": {
                  "description": "Qualitative growth label (\"Rising\", \"Early signal\", \"Accelerating\"). NOT a numeric percentage — the upstream does not compute \"+178%\"-style rates. Use signal_strength as the quantitative anchor.",
                  "type": "string"
                },
                "suggestion": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "saturated": {
            "description": "Saturated patterns to avoid",
            "items": {
              "properties": {
                "status": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Take a viral video and produce a fresh script that mirrors its structure and energy pattern for a new topic. Returns the extracted formula, scene-by-scene script with voiceover and visuals, camera directions, and text overlays. Use when the user finds a video they want to replicate the structure of. Pass either a video URL (TikTok, YouTube, or Instagram) or a transcript directly. When promoting a specific product, ALWAYS pass target_product + verified_product_facts so the generator does not fabricate product details.",
      "inputSchema": {
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "source_url"
            ]
          },
          {
            "required": [
              "transcript"
            ]
          }
        ],
        "properties": {
          "my_topic": {
            "description": "DEPRECATED alias for target_topic. Legacy clients only. Normalized internally.",
            "type": "string"
          },
          "niche": {
            "description": "Optional niche hint",
            "type": "string"
          },
          "platform": {
            "description": "Target platform for the remix. Adjusts pacing and CTA style if provided.",
            "enum": [
              "tiktok",
              "reels",
              "shorts"
            ],
            "type": "string"
          },
          "source_url": {
            "description": "TikTok/YouTube/Instagram URL — transcript will be auto-extracted",
            "type": "string"
          },
          "target_product": {
            "description": "The product the remix should promote. When provided, the generator will NOT invent product names, prices, timelines, features, or customer stories. Combined with verified_product_facts, this forces on-topic + grounded output.",
            "type": "string"
          },
          "target_topic": {
            "description": "What the remix should be about. Default: same niche as original.",
            "type": "string"
          },
          "transcript": {
            "description": "Pre-extracted transcript (alternative to source_url, faster)",
            "type": "string"
          },
          "verified_product_facts": {
            "description": "Facts the generator is allowed to cite about target_product (e.g. \"runs inside ChatGPT and Claude\", \"14 tools for viral research\"). Every specific product claim in the generated script is checked against this list — unsupported claims populate unsupported_claims[] and downgrade quality. If target_product is passed WITHOUT verified_product_facts, the response will land at degraded quality (generation cannot be grounded).",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "name": "viral_remix",
      "outputSchema": {
        "properties": {
          "camera_shots": {
            "description": "Phone-native camera direction per scene",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "credits_remaining": {
            "description": "Credits remaining after this call",
            "type": "number"
          },
          "cta_archetype": {
            "description": "Which CTA archetype the generator picked. Comment_gate is the failure-mode default for AI script generators; rotation tells you whether the prompt is working.",
            "enum": [
              "result_close",
              "soft_bio_pointer",
              "genuine_question",
              "pinned_comment",
              "comment_gate"
            ],
            "type": "string"
          },
          "extracted_formula": {
            "description": "The viral DNA formula extracted from the source",
            "type": "string"
          },
          "fresh_script": {
            "description": "Complete scene-by-scene script mirroring the source structure",
            "properties": {
              "cta": {
                "description": "Call-to-action closing",
                "type": "string"
              },
              "hook": {
                "description": "Opening hook line",
                "type": "string"
              },
              "scenes": {
                "description": "Scene-by-scene script with voiceover, visuals, and timing",
                "items": {
                  "type": "object"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "from_payg": {
            "description": "Whether credits came from pay-as-you-go balance",
            "type": "boolean"
          },
          "from_subscription": {
            "description": "Whether credits came from subscription",
            "type": "boolean"
          },
          "overlays": {
            "description": "Text overlay suggestions per scene",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "structural_skeleton": {
            "description": "Which structural skeleton the generator used (confession_to_result, mistake_to_correction, etc). Surfaces rotation across the fleet.",
            "type": "string"
          },
          "ugc_authenticity": {
            "description": "Tripwire for ad-shaped drift. Detected via regex on the produced script, not the model self-grade. If level=ad_leaning, surface to the user before shipping.",
            "properties": {
              "level": {
                "description": "Honest signal of whether the generator drifted ad-ward",
                "enum": [
                  "native",
                  "ad_leaning"
                ],
                "type": "string"
              },
              "reasons": {
                "description": "List of detected drift reasons (e.g. \"hook is 22 words\", \"CTA is comment-gate\")",
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "verify_hook": {
            "description": "The hook plus a suggested follow-up: the caller may pass it to score_hook for a structurally-independent score (the script generator deliberately does NOT self-rate). Informational only, not an instruction to call anything.",
            "type": "object"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Start tracking a creator so future calls can detect what changed. Creates a durable CreatorWatch + a baseline CreatorSnapshot capturing the creator's current viral DNA scores, format fingerprint, and top recent videos. Use when the user says 'track', 'watch', 'follow', 'keep an eye on' a creator/channel/handle. Idempotent — calling 'watch @same' twice with a fresh baseline in place returns the existing watch with credits_charged=0. Cost: 0 credits when a fresh existing watch snapshot or a compatible recent analyze_account cache can be reused. Otherwise a fresh baseline invokes analyze_account and costs 5 credits — this can happen even for an already-existing watch once freshness expires. Reuses the same 'analyze' permission as analyze_account — no new OAuth scope, no re-consent required.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "handle": {
            "description": "Creator handle (with or without @ prefix). Examples: \"@mrbeast\", \"mrbeast\".",
            "type": "string"
          },
          "platform": {
            "description": "Platform the creator publishes on. Same platforms as analyze_account.",
            "enum": [
              "tiktok",
              "instagram",
              "youtube"
            ],
            "type": "string"
          }
        },
        "required": [
          "handle",
          "platform"
        ],
        "type": "object"
      },
      "name": "watch_account",
      "outputSchema": {
        "properties": {
          "baseline_created_at": {
            "description": "ISO timestamp of the baseline snapshot",
            "type": "string"
          },
          "baseline_source": {
            "description": "watch_snapshot = existing CreatorWatch already had a fresh snapshot (0 credits); analysis_cache = recent analyze_account response reused to build a new baseline (0 credits); fresh = analyze_account invoked, 5 credits charged.",
            "enum": [
              "watch_snapshot",
              "analysis_cache",
              "fresh"
            ],
            "type": "string"
          },
          "creator": {
            "description": "Normalized \"@handle\" the watch is stored under",
            "type": "string"
          },
          "credits_charged": {
            "type": "number"
          },
          "data_age_days": {
            "description": "Age in days of the newest video in the baseline",
            "type": "number"
          },
          "message": {
            "type": "string"
          },
          "platform": {
            "enum": [
              "tiktok",
              "instagram",
              "youtube"
            ],
            "type": "string"
          },
          "snapshot_count": {
            "description": "Total snapshots stored for this watch so far",
            "type": "number"
          },
          "status": {
            "enum": [
              "tracked",
              "already_tracked"
            ],
            "type": "string"
          },
          "watch_id": {
            "type": "string"
          }
        },
        "type": "object"
      }
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:10d7f406001d7b36c11c19d27512063b4c62a9a16f53361e2add7dfda4e644b6 | sha256sum