Ad platform character limits, creative specs, A/B significance, UTM and policy checks. No account.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Run a two-proportion z-test on two variants of an ad, landing page or audience, and report the p-value, whether the difference is statistically significant at the chosen confidence level, and how much more traffic would be needed to resolve it if it is not. Use it for any comparison of two rates instead of judging the gap by eye.
Denominator for variant A: impressions for a click rate, clicks for a conversion rate.
Denominator for variant B.
Numerator for variant A.
Numerator for variant B.
Confidence level for the test.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http ad-spec-guard https://adsbeast.pro/api/mcp
Run a two-proportion z-test on two variants of an ad, landing page or audience, and report the p-value, whether the difference is statistically significant at the chosen confidence level, and how much more traffic would be needed to resolve it if it is not. Use it for any comparison of two rates instead of judging the gap by eye.
| Argument | Type | Description |
|---|---|---|
| confidence | number | Confidence level for the test. |
| variant_a_trials* | integer | Denominator for variant A: impressions for a click rate, clicks for a conversion rate. |
| variant_b_trials* | integer | Denominator for variant B. |
| variant_a_successes* | integer | Numerator for variant A. |
| variant_b_successes* | integer | Numerator for variant B. |
{
"type": "object",
"required": [
"variant_a_trials",
"variant_a_successes",
"variant_b_trials",
"variant_b_successes"
],
"properties": {
"confidence": {
"enum": [
0.8,
0.9,
0.95,
0.99
],
"type": "number",
"default": 0.95,
"description": "Confidence level for the test."
},
"variant_a_trials": {
"type": "integer",
"minimum": 1,
"description": "Denominator for variant A: impressions for a click rate, clicks for a conversion rate."
},
"variant_b_trials": {
"type": "integer",
"minimum": 1,
"description": "Denominator for variant B."
},
"variant_a_successes": {
"type": "integer",
"minimum": 0,
"description": "Numerator for variant A."
},
"variant_b_successes": {
"type": "integer",
"minimum": 0,
"description": "Numerator for variant B."
}
}
}Assemble a campaign URL with consistent UTM tagging, normalise the values so they do not split into duplicate rows in analytics, and report every correction made and every risk found. Also flags a source or medium that departs from the conventional value for the platform, which silently breaks channel grouping.
| Argument | Type | Description |
|---|---|---|
| term | string | Optional keyword or audience term. |
| medium* | string | Traffic medium, for example 'cpc' or 'paid_social'. |
| source* | string | Traffic source, for example 'google' or 'facebook'. |
| content | string | Optional creative or variant identifier. |
| base_url* | string | Landing page URL, with or without an existing query string. |
| campaign* | string | Campaign name. |
| platform | string | Optional platform key, used to check source and medium against the conventional values. |
| convention | string | Naming convention applied to every value. |
{
"type": "object",
"required": [
"base_url",
"source",
"medium",
"campaign"
],
"properties": {
"term": {
"type": "string",
"description": "Optional keyword or audience term."
},
"medium": {
"type": "string",
"description": "Traffic medium, for example 'cpc' or 'paid_social'."
},
"source": {
"type": "string",
"description": "Traffic source, for example 'google' or 'facebook'."
},
"content": {
"type": "string",
"description": "Optional creative or variant identifier."
},
"base_url": {
"type": "string",
"description": "Landing page URL, with or without an existing query string."
},
"campaign": {
"type": "string",
"description": "Campaign name."
},
"platform": {
"type": "string",
"description": "Optional platform key, used to check source and medium against the conventional values."
},
"convention": {
"enum": [
"lowercase_underscore",
"lowercase_hyphen",
"lowercase_pipe"
],
"type": "string",
"default": "lowercase_underscore",
"description": "Naming convention applied to every value."
}
}
}Scan ad copy for the two patterns behind most rejections: a business category the platform prohibits or gates behind certification, and a claim the platform treats as unverifiable. Returns each match with the governing policy page. This is a pattern pre-check, not an approval; only the platform's review decides whether an ad runs.
| Argument | Type | Description |
|---|---|---|
| text* | string | The ad copy to check. |
| platform* | string | Ad platform. Known keys: apple, google, linkedin, meta, microsoft, reddit, telegram, tiktok. |
| vertical | string | Optional business category, for example 'dental clinic'. |
| landing_url | string | Optional landing page URL, checked alongside the copy. |
{
"type": "object",
"required": [
"platform",
"text"
],
"properties": {
"text": {
"type": "string",
"description": "The ad copy to check."
},
"platform": {
"type": "string",
"description": "Ad platform. Known keys: apple, google, linkedin, meta, microsoft, reddit, telegram, tiktok."
},
"vertical": {
"type": "string",
"description": "Optional business category, for example 'dental clinic'."
},
"landing_url": {
"type": "string",
"description": "Optional landing page URL, checked alongside the copy."
}
}
}Decide whether a live campaign has produced enough data to justify pausing it, scaling its budget, rotating a creative or switching bidding strategy, and whether it is still inside the platform's learning phase. Returns the unmet requirements with the shortfall and an estimate of how long to wait. Call it before recommending any change and before calling a metric good or bad. For a verdict on a cost per acquisition or return on ad spend use 'judge_metric'; for a verdict on a click-through rate or conversion rate use 'judge_rate_metric', which is gated on clicks rather than conversions.
| Argument | Type | Description |
|---|---|---|
| spend | number | Amount spent so far, in USD. |
| clicks | number | Clicks recorded so far. |
| decision* | string | The decision being considered. |
| platform* | string | Ad platform. Known keys: google, google_display, google_search, linkedin, meta, microsoft, tiktok. |
| conversions | number | Conversions recorded so far. Omit it if it was not measured; do not pass 0 for unknown, because zero conversions after real traffic is a finding. |
| impressions | number | Impressions recorded so far. |
| days_running | number | Days the campaign has been delivering. |
{
"type": "object",
"required": [
"platform",
"decision"
],
"properties": {
"spend": {
"type": "number",
"minimum": 0,
"description": "Amount spent so far, in USD."
},
"clicks": {
"type": "number",
"minimum": 0,
"description": "Clicks recorded so far."
},
"decision": {
"enum": [
"pause",
"rotate_creative",
"scale_budget",
"change_bid_strategy",
"judge_metric",
"judge_rate_metric"
],
"type": "string",
"description": "The decision being considered."
},
"platform": {
"type": "string",
"description": "Ad platform. Known keys: google, google_display, google_search, linkedin, meta, microsoft, tiktok."
},
"conversions": {
"type": "number",
"minimum": 0,
"description": "Conversions recorded so far. Omit it if it was not measured; do not pass 0 for unknown, because zero conversions after real traffic is a finding."
},
"impressions": {
"type": "number",
"minimum": 0,
"description": "Impressions recorded so far."
},
"days_running": {
"type": "number",
"minimum": 0,
"description": "Days the campaign has been delivering."
}
}
}Work out whether a monthly budget can reach a target cost per acquisition or return on ad spend, and whether it produces enough weekly conversions for automated delivery to leave the learning phase. Nothing is filled in from industry averages: for any input not supplied, it solves for the value the goal would require and labels it as a condition rather than a forecast.
| Argument | Type | Description |
|---|---|---|
| ad_sets | integer | How many ad sets or campaigns the budget is split across. |
| currency | string | Currency code for the amounts supplied. |
| target_cpa | number | Target cost per acquisition. |
| target_roas | number | Target return on ad spend, as a multiple such as 4 for 4x. |
| expected_cpc | number | Cost per click. Supply it only if measured or quoted. |
| expected_cvr | number | Conversion rate, as 0.03 or 3 for three percent. Supply it only if measured. |
| monthly_budget* | number | Planned monthly media budget. |
| avg_order_value | number | Average order value, required with a return goal. |
{
"type": "object",
"required": [
"monthly_budget"
],
"properties": {
"ad_sets": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "How many ad sets or campaigns the budget is split across."
},
"currency": {
"type": "string",
"default": "USD",
"description": "Currency code for the amounts supplied."
},
"target_cpa": {
"type": "number",
"description": "Target cost per acquisition.",
"exclusiveMinimum": 0
},
"target_roas": {
"type": "number",
"description": "Target return on ad spend, as a multiple such as 4 for 4x.",
"exclusiveMinimum": 0
},
"expected_cpc": {
"type": "number",
"description": "Cost per click. Supply it only if measured or quoted.",
"exclusiveMinimum": 0
},
"expected_cvr": {
"type": "number",
"description": "Conversion rate, as 0.03 or 3 for three percent. Supply it only if measured.",
"exclusiveMinimum": 0
},
"monthly_budget": {
"type": "number",
"description": "Planned monthly media budget.",
"exclusiveMinimum": 0
},
"avg_order_value": {
"type": "number",
"description": "Average order value, required with a return goal.",
"exclusiveMinimum": 0
}
}
}Return the verified specification sheet for one ad platform: hard character limits per copy field, image formats with their required dimensions and file size caps, learning-phase windows, and the conversion history automated bidding needs. Call this before writing ad copy or briefing creative, instead of relying on remembered limits, which change and are frequently misremembered.
| Argument | Type | Description |
|---|---|---|
| section | string | Which part of the sheet to return. |
| platform* | string | Ad platform. One of: google, linkedin, meta, microsoft, telegram, tiktok. |
{
"type": "object",
"required": [
"platform"
],
"properties": {
"section": {
"enum": [
"all",
"text",
"image",
"thresholds"
],
"type": "string",
"default": "all",
"description": "Which part of the sheet to return."
},
"platform": {
"enum": [
"google",
"linkedin",
"meta",
"microsoft",
"telegram",
"tiktok"
],
"type": "string",
"description": "Ad platform. One of: google, linkedin, meta, microsoft, telegram, tiktok."
}
}
}Check drafted ad copy against the hard character limits of one platform, field by field, and report which fields exceed the limit and by how much. Use it on every draft before presenting it, because copy over the limit is rejected when the ad is uploaded, not when it is written.
| Argument | Type | Description |
|---|---|---|
| fields* | object | Map of field name to the drafted text, for example {"headline": "Same day delivery", "description": "..."}. Call get_platform_specs for the field names a platform accepts. |
| language | string | Language tag of the copy. Characters are counted as code points. |
| platform* | string | Ad platform. One of: google, linkedin, meta, microsoft, telegram, tiktok. |
| campaign_type | string | Optional campaign type, for example 'search' or 'performance_max'. Recorded in the result. |
{
"type": "object",
"required": [
"platform",
"fields"
],
"properties": {
"fields": {
"type": "object",
"description": "Map of field name to the drafted text, for example {\"headline\": \"Same day delivery\", \"description\": \"...\"}. Call get_platform_specs for the field names a platform accepts.",
"additionalProperties": {
"type": "string"
}
},
"language": {
"type": "string",
"default": "en",
"description": "Language tag of the copy. Characters are counted as code points."
},
"platform": {
"enum": [
"google",
"linkedin",
"meta",
"microsoft",
"telegram",
"tiktok"
],
"type": "string",
"description": "Ad platform. One of: google, linkedin, meta, microsoft, telegram, tiktok."
},
"campaign_type": {
"type": "string",
"description": "Optional campaign type, for example 'search' or 'performance_max'. Recorded in the result."
}
}
}Check an image or video against a platform placement's required dimensions, aspect ratio, file size cap and accepted file types. Width and height are enough to answer whether a size fits a placement; supply file size and type as well when the file exists, and the result says which checks it could not perform. Returns each violation with its severity and the expected value.
| Argument | Type | Description |
|---|---|---|
| width* | integer | Pixel width of the file or of the planned creative. |
| height* | integer | Pixel height of the file or of the planned creative. |
| platform* | string | Ad platform. One of: google, linkedin, meta, microsoft, telegram, tiktok. |
| file_bytes | integer | File size in bytes. Omit it when the file does not exist yet or its size is unknown; the weight check is then reported as not performed. Never estimate it. |
| format_key* | string | Placement format, for example 'feed_1x1' or 'story_9x16'. Call get_platform_specs with section 'image' for the list. |
| file_extension | string | File type without the dot, for example 'jpg', 'png', 'mp4'. Omit it when unknown; the type check is then reported as not performed. |
{
"type": "object",
"required": [
"platform",
"format_key",
"width",
"height"
],
"properties": {
"width": {
"type": "integer",
"minimum": 1,
"description": "Pixel width of the file or of the planned creative."
},
"height": {
"type": "integer",
"minimum": 1,
"description": "Pixel height of the file or of the planned creative."
},
"platform": {
"enum": [
"google",
"linkedin",
"meta",
"microsoft",
"telegram",
"tiktok"
],
"type": "string",
"description": "Ad platform. One of: google, linkedin, meta, microsoft, telegram, tiktok."
},
"file_bytes": {
"type": "integer",
"minimum": 1,
"description": "File size in bytes. Omit it when the file does not exist yet or its size is unknown; the weight check is then reported as not performed. Never estimate it."
},
"format_key": {
"type": "string",
"description": "Placement format, for example 'feed_1x1' or 'story_9x16'. Call get_platform_specs with section 'image' for the list."
},
"file_extension": {
"type": "string",
"description": "File type without the dot, for example 'jpg', 'png', 'mp4'. Omit it when unknown; the type check is then reported as not performed."
}
}
}Inspect the UTM parameters already on a URL and report missing required parameters and values that will fragment reporting, such as mixed case or encoded spaces. Does not rewrite the URL.
| Argument | Type | Description |
|---|---|---|
| url* | string | The tagged URL to inspect. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The tagged URL to inspect."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.