How To Make Money On Snapchat

calculate_growth_pace

Read-onlyIdempotent

CALCULATION. Use this when you need the daily and weekly pace to close each numeric gap within target_days, with scenarios and labeled assumptions. This is a projection, not a prediction. Do not use it to learn the size of the gap (calculate_gap) or to list the rules (get_monetization_requirements).

Input Schema

TableJSON Schema

Name	Required	Description	Default
`metrics`	Yes	Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error.
`program`	No	Programs the calculation tools evaluate in v1. Other in-scope programs (payouts, tax, snap_star, creator_monetization_policy, recommendation_eligibility, brand_partnerships) are served as FACTs by get_monetization_requirements; Snap Star status is evaluated as a prerequisite inside unified_monetization_program.	unified_monetization_program
`target_days`	Yes
`metrics_to_pace`	No
`already_enrolled`	No	Set true only if the creator is already enrolled in the Monetization Program. Default false: only entry (invitation) requirements are evaluated. When true, ongoing requirements for enrolled creators are reported in a separate section.
`observed_daily_change`	No	Optional recent average daily change per metric (caller-supplied, may be negative) for comparing required vs. current pace.

Output Schema

TableJSON Schema

Name	Required	Description
`tool`	Yes
`facts`	Yes
`paces`	Yes	Entry requirements only.
`notice`	Yes	Non-affiliation notice included in every response.
`program`	Yes	Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.
`sources`	Yes
`unknowns`	Yes
`warnings`	No	Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.
`api_version`	Yes
`target_date`	Yes
`target_days`	Yes
`generated_at`	Yes
`ongoing_paces`	Yes	null unless already_enrolled=true.
`data_freshness`	Yes
`recommendations`	Yes
`already_enrolled`	Yes
`projection_disclaimer`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedSep 30, 2026

changedInput schema / description

Previous value: -"CALCULATION tool. Required daily and weekly pace to close each numeric gap within target_days, with a linear scenario plus alternatives and labeled assumptions. A projection, never a prediction."New value: +"CALCULATION tool. Required daily and weekly pace to close each numeric gap within target_days, with a linear scenario plus alternatives and labeled assumptions. A projection, never a prediction. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error."

changedInput schema / properties / metrics / description

Previous value: -"Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored."New value: +"Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$id": "https://howtomakemoneyonsnapchat.com/schemas/v1/calculate_growth_pace.output.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "description": "Fields present in every successful tool output.",
+      "properties": {
+        "api_version": {
+          "const": "v1"
+        },
+        "data_freshness": {
+          "additionalProperties": false,
+          "properties": {
+            "generated_at": {
+              "format": "date-time",
+              "type": "string"
+            },
+            "newest_verified_at": {
+              "format": "date",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "oldest_verified_at": {
+              "format": "date",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "policy": {
+              "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'",
+              "type": "string"
+            },
+            "rules_db_version": {
+              "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n",
+              "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$",
+              "type": "string"
+            },
+            "stale_rule_ids": {
+              "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.",
+              "items": {
+                "maxLength": 120,
+                "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$",
+                "type": "string"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "rules_db_version",
+            "generated_at",
+            "oldest_verified_at",
+            "newest_verified_at",
+            "stale_rule_ids",
+            "policy"
+          ],
+          "type": "object"
+        },
+        "generated_at": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "notice": {
+          "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.",
+          "description": "Non-affiliation notice included in every response.",
+          "type": "string"
+        },
+        "sources": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "publisher": {
+                "type": "string"
+              },
+              "supports_rule_ids": {
+                "items": {
+                  "maxLength": 120,
+                  "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$",
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "title": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "url": {
+                "format": "uri",
+                "type": "string"
+              },
+              "verified_at": {
+                "format": "date",
+                "type": "string"
+              }
+            },
+            "required": [
+              "url",
+              "publisher",
+              "verified_at",
+              "supports_rule_ids"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "tool": {
+          "type": "string"
+        },
+        "warnings": {
+          "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "tool",
+        "api_version",
+        "notice",
+        "generated_at",
+        "sources",
+        "data_freshness"
+      ],
+      "type": "object"
+    }
+  ],
+  "properties": {
+    "already_enrolled": {
+      "type": "boolean"
+    },
+    "api_version": {
+      "const": "v1"
+    },
+    "data_freshness": {
+      "additionalProperties": false,
+      "properties": {
+        "generated_at": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "newest_verified_at": {
+          "format": "date",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "oldest_verified_at": {
+          "format": "date",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "policy": {
+          "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'",
+          "type": "string"
+        },
+        "rules_db_version": {
+          "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$",
+          "type": "string"
+        },
+        "stale_rule_ids": {
+          "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.",
+          "items": {
+            "maxLength": 120,
+            "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$",
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "rules_db_version",
+        "generated_at",
+        "oldest_verified_at",
+        "newest_verified_at",
+        "stale_rule_ids",
+        "policy"
+      ],
+      "type": "object"
+    },
+    "facts": {
+      "items": {
+        "additionalProperties": false,
+        "description": "FACT: a rule record as stored in the versioned rules database (approved records only).",
+        "properties": {
+          "applies_to": {
+            "enum": [
+              "entry",
+              "enrolled_creators",
+              "all",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "changed_after": {
+            "description": "Inclusive start of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.",
+            "format": "date",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "changed_before": {
+            "description": "Inclusive end of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.",
+            "format": "date",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "claim": {
+            "type": "string"
+          },
+          "date_note": {
+            "description": "How changed_after and changed_before were established. Null when there is no window note. Not a substitute for source_url.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "effective_date": {
+            "format": "date",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "effective_date_note": {
+            "const": "not published by Snap",
+            "description": "Present when effective_date is null because Snap did not publish a date. effective_date stays null."
+          },
+          "iso_countries": {
+            "description": "ISO 3166-1 codes for each name in a country list, from the reviewed country map. Omitted unless this fact is a country list.",
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "alpha2": {
+                  "type": "string"
+                },
+                "alpha3": {
+                  "type": "string"
+                },
+                "numeric": {
+                  "type": "string"
+                },
+                "snap_name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "snap_name",
+                "alpha2",
+                "alpha3",
+                "numeric"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "label": {
+            "const": "FACT"
+          },
+          "metric": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "mvp_scope": {
+            "enum": [
+              "in_scope",
+              "out_of_scope"
+            ],
+            "type": "string"
+          },
+          "notes": {
+            "type": "string"
+          },
+          "operator": {
+            "enum": [
+              "gte",
+              "gt",
+              "lte",
+              "lt",
+              "eq",
+              "in",
+              "is_true",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "program": {
+            "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.",
+            "pattern": "^[a-z0-9_]{2,64}$",
+            "type": "string"
+          },
+          "publisher": {
+            "type": "string"
+          },
+          "related_rule_ids": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "requirement_phase": {
+            "enum": [
+              "entry",
+              "ongoing",
+              "entry_and_ongoing",
+              "not_applicable"
+            ],
+            "type": "string"
+          },
+          "requires_user_confirmation": {
+            "type": "boolean"
+          },
+          "rule_id": {
+            "maxLength": 120,
+            "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$",
+            "type": "string"
+          },
+          "rule_type": {
+            "description": "Role of the rule, copied from the rules database. Omitted by older clients. Used to group answer pages.",
+            "enum": [
+              "eligibility_threshold",
+              "eligibility_condition",
+              "ongoing_condition",
+              "payout_term",
+              "tax_term",
+              "content_policy",
+              "program_fact",
+              "program_status",
+              "supplementary_note",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "format": "uri",
+            "type": "string"
+          },
+          "status": {
+            "enum": [
+              "current",
+              "historical",
+              "unverified"
+            ],
+            "type": "string"
+          },
+          "supersedes": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "unit": {
+            "type": "string"
+          },
+          "value": {
+            "anyOf": [
+              {
+                "type": [
+                  "number",
+                  "string",
+                  "boolean",
+                  "null"
+                ]
+              },
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            ]
+          },
+          "verified_at": {
+            "format": "date",
+            "type": "string"
+          },
+          "version": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "window_days": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "label",
+          "rule_id",
+          "version",
+          "program",
+          "claim",
+          "value",
+          "unit",
+          "status",
+          "source_url",
+          "publisher",
+          "verified_at",
+          "effective_date",
+          "requires_user_confirmation",
+          "applies_to",
+          "requirement_phase",
+          "mvp_scope",
+          "notes"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "generated_at": {
+      "format": "date-time",
+      "type": "string"
+    },
+    "notice": {
+      "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.",
+      "description": "Non-affiliation notice included in every response.",
+      "type": "string"
+    },
+    "ongoing_paces": {
+      "additionalProperties": false,
+      "description": "null unless already_enrolled=true.",
+      "properties": {
+        "note": {
+          "const": "Ongoing requirements apply only to creators already enrolled in the Monetization Program. Snap says the 100-hour Spotlight view-time requirement is needed to qualify for maximum Creator Rewards; Snap does not say that rewards stop below it."
+        },
+        "paces": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "already_met": {
+                "type": "boolean"
+              },
+              "current": {
+                "type": "number"
+              },
+              "gap": {
+                "minimum": 0,
+                "type": "number"
+              },
+              "metric": {
+                "enum": [
+                  "followers",
+                  "view_time_hours_28d",
+                  "spotlight_view_time_hours_28d",
+                  "posts_per_month",
+                  "active_posting_days_28d"
+                ],
+                "type": "string"
+              },
+              "metric_kind": {
+                "enum": [
+                  "cumulative",
+                  "rolling_window"
+                ],
+                "type": "string"
+              },
+              "observed_daily_change": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "required_to_observed_ratio": {
+                "description": "linear required_daily / observed_daily_change; null if observed not supplied or <= 0.",
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "rule_id": {
+                "maxLength": 120,
+                "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$",
+                "type": "string"
+              },
+              "scenarios": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "assumptions": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "minItems": 1,
+                      "type": "array"
+                    },
+                    "computable": {
+                      "type": "boolean"
+                    },
+                    "formula": {
+                      "type": "string"
+                    },
+                    "label": {
+                      "const": "CALCULATION"
+                    },
+                    "name": {
+                      "description": "linear: shortfall divided by the caller-chosen days, (T - C) / N. Used for cumulative metrics and for rolling-window metrics. compound: constant daily % growth (cumulative metrics; not computable when current = 0). rolling_window_replacement remains in the enum and is not produced.",
+                      "enum": [
+                        "linear",
+                        "compound",
+                        "rolling_window_replacement"
+                      ],
+                      "type": "string"
+                    },
+                    "not_computable_reason": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "required_daily": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "required_daily_growth_rate_pct": {
+                      "description": "compound scenario only",
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "required_weekly": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "unit": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "label",
+                    "name",
+                    "computable",
+                    "required_daily",
+                    "required_weekly",
+                    "unit",
+                    "formula",
+                    "assumptions"
+                  ],
+                  "type": "object"
+                },
+                "minItems": 1,
+                "type": "array"
+              },
+              "threshold": {
+                "type": "number"
+              },
+              "window_days": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "rule_id",
+              "metric",
+              "metric_kind",
+              "current",
+              "threshold",
+              "gap",
+              "scenarios"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "note",
+        "paces"
+      ],
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "paces": {
+      "description": "Entry requirements only.",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "already_met": {
+            "type": "boolean"
+          },
+          "current": {
+            "type": "number"
+          },
+          "gap": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "metric": {
+            "enum": [
+              "followers",
+              "view_time_hours_28d",
+              "spotlight_view_time_hours_28d",
+              "posts_per_month",
+              "active_posting_days_28d"
+            ],
+            "type": "string"
+          },
+          "metric_kind": {
+            "enum": [
+              "cumulative",
+              "rolling_window"
+            ],
+            "type": "string"
+          },
+          "observed_daily_change": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "required_to_observed_ratio": {
+            "description": "linear required_daily / observed_daily_change; null if observed not supplied or <= 0.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "rule_id": {
+            "maxLength": 120,
+            "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$",
+            "type": "string"
+          },
+          "scenarios": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "assumptions": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "minItems": 1,
+                  "type": "array"
+                },
+                "computable": {
+                  "type": "boolean"
+                },
+                "formula": {
+                  "type": "string"
+                },
+                "label": {
+                  "const": "CALCULATION"
+                },
+                "name": {
+                  "description": "linear: shortfall divided by the caller-chosen days, (T - C) / N. Used for cumulative metrics and for rolling-window metrics. compound: constant daily % growth (cumulative metrics; not computable when current = 0). rolling_window_replacement remains in the enum and is not produced.",
+                  "enum": [
+                    "linear",
+                    "compound",
+                    "rolling_window_replacement"
+                  ],
+                  "type": "string"
+                },
+                "not_computable_reason": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "required_daily": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "required_daily_growth_rate_pct": {
+                  "description": "compound scenario only",
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "required_weekly": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "unit": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "label",
+                "name",
+                "computable",
+                "required_daily",
+                "required_weekly",
+                "unit",
+                "formula",
+                "assumptions"
+              ],
+              "type": "object"
+            },
+            "minItems": 1,
+            "type": "array"
+          },
+          "threshold": {
+            "type": "number"
+          },
+          "window_days": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "rule_id",
+          "metric",
+          "metric_kind",
+          "current",
+          "threshold",
+          "gap",
+          "scenarios"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "program": {
+      "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.",
+      "pattern": "^[a-z0-9_]{2,64}$",
+      "type": "string"
+    },
+    "projection_disclaimer": {
+      "const": "Projections show the pace required under stated assumptions. They are not predictions of what will happen."
+    },
+    "recommendations": {
+      "items": {
+        "additionalProperties": false,
+        "description": "RECOMMENDATION: our suggestion, never a Snap rule. Short and structured; the calling agent writes prose.",
+        "properties": {
+          "assumptions": {
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array"
+          },
+          "label": {
+            "const": "RECOMMENDATION"
+          },
+          "linked_rule_id": {
+            "maxLength": 120,
+            "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$",
+            "type": "string"
+          },
+          "measurable_target": {
+            "additionalProperties": false,
+            "properties": {
+              "by_date": {
+                "format": "date",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "metric": {
+                "description": "Closed vocabulary of creator metrics the engines understand.",
+                "enum": [
+                  "followers",
+                  "view_time_hours_28d",
+                  "spotlight_view_time_hours_28d",
+                  "meets_age_requirement",
+                  "country",
+                  "is_snap_star",
+                  "posts_per_month",
+                  "active_posting_days_28d"
+                ],
+                "type": "string"
+              },
+              "unit": {
+                "type": "string"
+              },
+              "value": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "metric",
+              "value",
+              "unit"
+            ],
+            "type": "object"
+          },
+          "objective": {
+            "maxLength": 200,
+            "type": "string"
+          },
+          "order": {
+            "description": "1 = address first (the binding constraint). An ordering, not a score.",
+            "minimum": 1,
+            "type": "integer"
+          },
+          "realism_note": {
+            "description": "Plain statement when the math is unrealistic, e.g. 'Required pace is 20x your observed pace.'",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "reason": {
+            "maxLength": 300,
+            "type": "string"
+          },
+          "risks": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "label",
+          "objective",
+          "reason",
+          "linked_rule_id",
+          "measurable_target",
+          "assumptions",
+          "risks"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "sources": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "publisher": {
+            "type": "string"
+          },
+          "supports_rule_ids": {
+            "items": {
+              "maxLength": 120,
+              "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$",
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "title": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "url": {
+            "format": "uri",
+            "type": "string"
+          },
+          "verified_at": {
+            "format": "date",
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "publisher",
+          "verified_at",
+          "supports_rule_ids"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "target_date": {
+      "format": "date",
+      "type": "string"
+    },
+    "target_days": {
+      "type": "integer"
+    },
+    "tool": {
+      "const": "calculate_growth_pace"
+    },
+    "unknowns": {
+      "items": {
+        "additionalProperties": false,
+        "description": "A requirement we could not evaluate, with the reason and what would resolve it.",
+        "properties": {
+          "how_to_resolve": {
+            "type": "string"
+          },
+          "missing_metric": {
+            "anyOf": [
+              {
+                "description": "Closed vocabulary of creator metrics the engines understand.",
+                "enum": [
+                  "followers",
+                  "view_time_hours_28d",
+                  "spotlight_view_time_hours_28d",
+                  "meets_age_requirement",
+                  "country",
+                  "is_snap_star",
+                  "posts_per_month",
+                  "active_posting_days_28d"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "reason": {
+            "enum": [
+              "missing_input",
+              "rule_unverified",
+              "requires_user_confirmation",
+              "not_computable_from_metrics",
+              "rule_value_not_numeric"
+            ],
+            "type": "string"
+          },
+          "rule_id": {
+            "maxLength": 120,
+            "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "rule_id",
+          "reason",
+          "how_to_resolve"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "warnings": {
+      "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "tool",
+    "api_version",
+    "notice",
+    "generated_at",
+    "sources",
+    "data_freshness",
+    "program",
+    "already_enrolled",
+    "target_days",
+    "target_date",
+    "paces",
+    "ongoing_paces",
+    "projection_disclaimer",
+    "unknowns",
+    "facts",
+    "recommendations"
+  ],
+  "title": "calculate_growth_pace output",
+  "type": "object"
+}

First observedSep 28, 2026

TDQS

A4.4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish readOnly, idempotent, non-destructive, closed-world behavior, so the safety profile needs no restating. The description adds genuinely new framing: the result is a projection with labeled assumptions rather than a prediction, which shapes how the agent should present output. It stops short of anything about error/unknown handling, but that is disclosed in the schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences, front-loaded with the operation type and the use condition, then the nature of the output, then the exclusions. No filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With a rich schema, an output schema, and strong annotations, the description supplies what structured fields cannot: the routing decision and the projection-not-prediction expectation. It does not summarize that missing metrics yield 'unknowns' rather than guesses, but that constraint is already stated in the schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 67% and the schema documents the nuanced fields (metrics, observed_daily_change, already_enrolled, plausibility warnings) in detail. The description only references target_days indirectly via 'within target_days' and adds no new parameter meaning, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (calculate) and the exact artifact produced (daily and weekly pace to close each numeric gap within target_days), including the qualitative form of the output (scenarios, labeled assumptions). It also names two siblings it is not, so an agent can route without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit trigger (need pace to close a gap within target_days) plus explicit exclusions pointing at the correct alternatives: calculate_gap for gap size and get_monetization_requirements for rules. When-to-use, when-not-to-use, and alternatives are all present.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All How To Make Money On Snapchat tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?