LeaderboardBack to leaderboard — loading return destination
Opening report…
Loading report overview
M
MCP server
server.example.com/mcp
Tools and resources for your MCP client, with a public quality report and detailed checks.
Protocol
MCP 2025-11-25
Server version
1.0.0
Website
server.example.com
Supports
Tools · Resources
Overall score
90 /100
How is this score calculated?
Server metadata
Loading server metadata
Reviewed90/100
Discoverability
Loading discoverability
Reviewed90/100
Protocol
Loading protocol
Reviewed90/100
Tools
Loading tools
Reviewed90/100
MCP Apps
Loading mcp apps
Reviewed90/100
Tool documentation quality
Loading tool documentation quality
Reviewed90/100
LeaderboardBack to leaderboard — loading return destination
H
HYPD AI for Ad Library
adlibrary.hypd.ai/mcp
HYPD's competitor ad research on public data: the Meta Ad Library and Google Ads Transparency, who advertises on a Google search, competing domains and landing-page screenshots
HYPD's competitor ad research on public data: the Meta Ad Library and Google Ads Transparency, who advertises on a Google search, competing domains and landing-page screenshots
HYPD Ad Library: research the ads competitors run, from public data — the Meta Ad Library (Facebook and Instagram) and Google Ads Transparency (Search, YouTube, Shopping, Maps, Play) — plus who bids on a Google search, which domains compete with a site, and a screenshot of any landing page. No ad account connection is needed. Call `init` at the start of a new conversation and follow the guide it returns. Resolve a brand to its advertiser first (adlib_meta_find_advertisers, adlib_google_find_advertisers), then list its ads. Pass countries, location and language from what the user said or ask them; never assume worldwide. Spend and impressions are not published for commercial ads: never estimate them as if they were. Each lookup uses the user's plan allowance; paging a stored result with result_id is free. Report tool errors as errors — never invent ads a tool did not return.
Discoverability
2 pass · 1 partial2 passed · 1 partial42/100
Client listings and public setup information.
mcp.json or server-card.json
Either mcp.json or an MCP Server Card declaring this endpoint passes.
The MCP Server Card declares this server's exact endpoint.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
Returns the Ad Library guide — call it first in a new conversation. It explains which adlib_* tool answers which question, a workflow from a brand name to its Meta and Google ads, the country and market conventions, what the libraries publish and what they don't (no spend for commercial ads), how lookups use the plan allowance, and starter prompts.
The description explains the capability, when to use it, and what to expect.
Inputs100/100
This tool declares no inputs, so argument descriptions are not needed.
No input fields.
Annotations100/100
All four behavior hints are declared.
{
"title": "Load the Ad Library guide",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
Output schema81/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"skill"
],
"properties": {
"skill": {
"type": "object",
"required": [
"name",
"title",
"description",
"updatedAt",
"content"
],
"properties": {
"name": {
"type": "string",
"description": "The guide's id."
},
"title": {
"type": "string",
"description": "The guide's title."
},
"content": {
"type": "string",
"description": "The guide itself, in Markdown."
},
"updatedAt": {
"type": [
"string",
"null"
],
"description": "When the guide last changed (ISO 8601), if known."
},
"description": {
"type": "string",
"description": "What the guide covers."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "init",
"title": "Load the Ad Library guide",
"description": "Returns the Ad Library guide — call it first in a new conversation. It explains which adlib_* tool answers which question, a workflow from a brand name to its Meta and Google ads, the country and market conventions, what the libraries publish and what they don't (no spend for commercial ads), how lookups use the plan allowance, and starter prompts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"skill"
],
"properties": {
"skill": {
"type": "object",
"required": [
"name",
"title",
"description",
"updatedAt",
"content"
],
"properties": {
"name": {
"type": "string",
"description": "The guide's id."
},
"title": {
"type": "string",
"description": "The guide's title."
},
"content": {
"type": "string",
"description": "The guide itself, in Markdown."
},
"updatedAt": {
"type": [
"string",
"null"
],
"description": "When the guide last changed (ISO 8601), if known."
},
"description": {
"type": "string",
"description": "What the guide covers."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"title": "Load the Ad Library guide",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
Finds Facebook and Instagram ads in Meta's public Ad Library that mention a keyword or phrase, across every advertiser: the way to see how a market advertises, or to discover competitors you didn't know. query is the text to look for, matched as a phrase; match "all_words" finds every word anywhere in the ad. Narrow with countries (two-letter codes), ad_active_status (active, inactive or all) and media_type (image, video, meme, none or all). Each row has the ad's text, headline and call to action, its media, the advertiser's page_name and page_id, the platforms it ran on and its run dates; up to 12 thumbnails show inline. Text over 2,000 characters is cut and marked body_truncated: adlib_meta_ad_detail has the whole text. Scope every country to the EU, EEA or UK to add Meta's official transparency fields (reach, targeting, who paid), marked data_source "official". Meta publishes no spend or impressions for commercial ads. Media links expire within hours. Page on with next_page_token as page_token.
The description explains the capability, when to use it, and what to expect.
Inputs81/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
Keyword or phrase to search the Meta Ad Library for.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
match
phrase (default): the words together, in this order. all_words: every word somewhere in the ad, in any order.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
countries
Two-letter ISO country codes to scope results, e.g. ["US","GB"]. Omit for all countries. Scoping every code to the EU-27, EEA (Iceland/Liechtenstein/Norway), or UK (GB) unlocks Meta's official first-party fields (audience reach, targeting, payer).
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
ad_active_status
Filter by delivery status: 'active', 'inactive', or 'all'.
Clear enough to supply this argument.
media_type
Filter by creative media type.
Explain the meaning of this value, not just its name.
include_thumbnail_data
Set true to receive each thumbnail as a data: URI (thumbnail_data_uri) instead of an inline preview. Adds roughly 10-20 KB per ad.
Clear enough to supply this argument.
page_size
Rows per page, at most 100. Defaults to 25.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page_token
next_page_token from a previous call, to read the next page.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "Search Meta ads by keyword",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
Output schema87/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"rows",
"next_page_token"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"media": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "image or video."
},
"image_url": {
"type": [
"string",
"null"
],
"description": "The full-size image."
},
"video_url": {
"type": [
"string",
"null"
],
"description": "The video file."
},
"poster_url": {
"type": [
"string",
"null"
],
"description": "The video's cover image."
},
"thumbnail_data_uri": {
"type": [
"string",
"null"
],
"description": "The thumbnail as a data: URI, only with include_thumbnail_data."
}
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "The ad's images and videos."
},
"reach": {
"type": [
"number",
"null"
],
"description": "People reached, where Meta publishes it."
},
"spend": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Spend as a range, only for ads Meta publishes it for (political and issue ads). Commercial ads have none."
},
"page_id": {
"type": [
"string",
"null"
],
"description": "The advertiser's Facebook Page id, what adlib_meta_advertiser_ads takes."
},
"creative": {
"anyOf": [
{
"type": "object",
"properties": {
"body": {
"type": [
"string",
"null"
],
"description": "The ad's primary text."
},
"cta_type": {
"type": [
"string",
"null"
],
"description": "The call to action button, e.g. SHOP_NOW."
},
"headline": {
"type": [
"string",
"null"
],
"description": "The headline under the media."
},
"link_url": {
"type": [
"string",
"null"
],
"description": "Where the ad sends people."
},
"body_truncated": {
"type": [
"boolean",
"null"
],
"description": "true when a list cut the text to its start; adlib_meta_ad_detail returns all of it."
}
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The ad's copy and destination."
},
"end_date": {
"type": [
"string",
"null"
],
"description": "The day it stopped, or null while it runs."
},
"countries": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Countries it delivered to, as two-letter codes; null when unknown."
},
"is_active": {
"type": [
"boolean",
"null"
],
"description": "Whether it is running now."
},
"page_name": {
"type": [
"string",
"null"
],
"description": "The Facebook Page's name."
},
"start_date": {
"type": [
"string",
"null"
],
"description": "The day it started running."
},
"data_source": {
"type": [
"string",
"null"
],
"description": "official for Meta's own fields (ads scoped to the EU, EEA or UK), web otherwise."
},
"impressions": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Impressions as a range, only for ads Meta publishes them for (political and issue ads)."
},
"target_ages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Targeted age range (official ads only)."
},
"ad_archive_id": {
"type": [
"string",
"null"
],
"description": "The ad's id in the Ad Library, what adlib_meta_ad_detail takes."
},
"target_gender": {
"type": [
"string",
"null"
],
"description": "Targeted gender (official ads only)."
},
"eu_total_reach": {
"type": [
"number",
"null"
],
"description": "People reached in the EU (official ads only)."
},
"page_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "The Page's categories, e.g. Clothing store."
},
"target_locations": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Targeted locations (official ads only)."
},
"beneficiary_payers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Who benefits from and who pays for the ad (official ads only)."
},
"publisher_platforms": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Where it runs: facebook, instagram, messenger, audience_network."
},
"age_country_gender_reach_breakdown": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Reach by age, country and gender (official ads only)."
}
},
"additionalProperties": {}
},
"description": "This page of ads."
},
"next_page_token": {
"type": [
"string",
"null"
],
"description": "Pass as page_token for the next page; null on the last page."
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "adlib_meta_search",
"title": "Search Meta ads by keyword",
"description": "Finds Facebook and Instagram ads in Meta's public Ad Library that mention a keyword or phrase, across every advertiser: the way to see how a market advertises, or to discover competitors you didn't know. query is the text to look for, matched as a phrase; match \"all_words\" finds every word anywhere in the ad. Narrow with countries (two-letter codes), ad_active_status (active, inactive or all) and media_type (image, video, meme, none or all). Each row has the ad's text, headline and call to action, its media, the advertiser's page_name and page_id, the platforms it ran on and its run dates; up to 12 thumbnails show inline. Text over 2,000 characters is cut and marked body_truncated: adlib_meta_ad_detail has the whole text. Scope every country to the EU, EEA or UK to add Meta's official transparency fields (reach, targeting, who paid), marked data_source \"official\". Meta publishes no spend or impressions for commercial ads. Media links expire within hours. Page on with next_page_token as page_token.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"match": {
"enum": [
"phrase",
"all_words"
],
"type": "string",
"description": "phrase (default): the words together, in this order. all_words: every word somewhere in the ad, in any order."
},
"query": {
"type": "string",
"minLength": 1,
"description": "Keyword or phrase to search the Meta Ad Library for."
},
"countries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"minItems": 1,
"description": "Two-letter ISO country codes to scope results, e.g. [\"US\",\"GB\"]. Omit for all countries. Scoping every code to the EU-27, EEA (Iceland/Liechtenstein/Norway), or UK (GB) unlocks Meta's official first-party fields (audience reach, targeting, payer)."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, at most 100. Defaults to 25."
},
"media_type": {
"enum": [
"all",
"image",
"video",
"meme",
"none"
],
"type": "string",
"description": "Filter by creative media type."
},
"page_token": {
"type": "string",
"minLength": 1,
"description": "next_page_token from a previous call, to read the next page."
},
"ad_active_status": {
"enum": [
"active",
"inactive",
"all"
],
"type": "string",
"description": "Filter by delivery status: 'active', 'inactive', or 'all'."
},
"include_thumbnail_data": {
"type": "boolean",
"description": "Set true to receive each thumbnail as a data: URI (thumbnail_data_uri) instead of an inline preview. Adds roughly 10-20 KB per ad."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"rows",
"next_page_token"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"media": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "image or video."
},
"image_url": {
"type": [
"string",
"null"
],
"description": "The full-size image."
},
"video_url": {
"type": [
"string",
"null"
],
"description": "The video file."
},
"poster_url": {
"type": [
"string",
"null"
],
"description": "The video's cover image."
},
"thumbnail_data_uri": {
"type": [
"string",
"null"
],
"description": "The thumbnail as a data: URI, only with include_thumbnail_data."
}
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "The ad's images and videos."
},
"reach": {
"type": [
"number",
"null"
],
"description": "People reached, where Meta publishes it."
},
"spend": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Spend as a range, only for ads Meta publishes it for (political and issue ads). Commercial ads have none."
},
"page_id": {
"type": [
"string",
"null"
],
"description": "The advertiser's Facebook Page id, what adlib_meta_advertiser_ads takes."
},
"creative": {
"anyOf": [
{
"type": "object",
"properties": {
"body": {
"type": [
"string",
"null"
],
"description": "The ad's primary text."
},
"cta_type": {
"type": [
"string",
"null"
],
"description": "The call to action button, e.g. SHOP_NOW."
},
"headline": {
"type": [
"string",
"null"
],
"description": "The headline under the media."
},
"link_url": {
"type": [
"string",
"null"
],
"description": "Where the ad sends people."
},
"body_truncated": {
"type": [
"boolean",
"null"
],
"description": "true when a list cut the text to its start; adlib_meta_ad_detail returns all of it."
}
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The ad's copy and destination."
},
"end_date": {
"type": [
"string",
"null"
],
"description": "The day it stopped, or null while it runs."
},
"countries": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Countries it delivered to, as two-letter codes; null when unknown."
},
"is_active": {
"type": [
"boolean",
"null"
],
"description": "Whether it is running now."
},
"page_name": {
"type": [
"string",
"null"
],
"description": "The Facebook Page's name."
},
"start_date": {
"type": [
"string",
"null"
],
"description": "The day it started running."
},
"data_source": {
"type": [
"string",
"null"
],
"description": "official for Meta's own fields (ads scoped to the EU, EEA or UK), web otherwise."
},
"impressions": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Impressions as a range, only for ads Meta publishes them for (political and issue ads)."
},
"target_ages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Targeted age range (official ads only)."
},
"ad_archive_id": {
"type": [
"string",
"null"
],
"description": "The ad's id in the Ad Library, what adlib_meta_ad_detail takes."
},
"target_gender": {
"type": [
"string",
"null"
],
"description": "Targeted gender (official ads only)."
},
"eu_total_reach": {
"type": [
"number",
"null"
],
"description": "People reached in the EU (official ads only)."
},
"page_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "The Page's categories, e.g. Clothing store."
},
"target_locations": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Targeted locations (official ads only)."
},
"beneficiary_payers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Who benefits from and who pays for the ad (official ads only)."
},
"publisher_platforms": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Where it runs: facebook, instagram, messenger, audience_network."
},
"age_country_gender_reach_breakdown": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Reach by age, country and gender (official ads only)."
}
},
"additionalProperties": {}
},
"description": "This page of ads."
},
"next_page_token": {
"type": [
"string",
"null"
],
"description": "Pass as page_token for the next page; null on the last page."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search Meta ads by keyword",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
Turns a brand or company name into the Facebook Page behind its Meta ads: each row's page_id is what adlib_meta_advertiser_ads takes, with the page_name, categories, verification and follower count, so you can tell the real brand from look-alikes. Pass query and, when you know the market, countries. The lookup is best effort: when it finds nothing for a niche or ambiguous name, run adlib_meta_search in the brand's country and read page_id off its rows, or use a Facebook Page id the user knows. Page on with next_page_token as page_token.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
Brand or company name to look up its advertiser page id(s).
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
countries
Two-letter ISO country codes to scope results, e.g. ["US","GB"]. Omit for all countries. Scoping every code to the EU-27, EEA (Iceland/Liechtenstein/Norway), or UK (GB) unlocks Meta's official first-party fields (audience reach, targeting, payer).
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page_size
Rows per page, at most 100. Defaults to 25.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page_token
next_page_token from a previous call, to read the next page.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Find a brand on Meta",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
Output schema82/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"rows",
"next_page_token"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"likes": {
"type": [
"number",
"null"
],
"description": "The Page's likes."
},
"page_id": {
"type": [
"string",
"null"
],
"description": "The advertiser's Facebook Page id, what adlib_meta_advertiser_ads takes."
},
"verified": {
"type": [
"boolean",
"null"
],
"description": "Whether Meta verified the Page."
},
"page_name": {
"type": [
"string",
"null"
],
"description": "The Facebook Page's name."
},
"ig_username": {
"type": [
"string",
"null"
],
"description": "The linked Instagram account."
},
"ig_followers": {
"type": [
"number",
"null"
],
"description": "Followers of that Instagram account."
},
"page_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "The Page's categories, e.g. Clothing store."
}
},
"additionalProperties": {}
},
"description": "This page of advertisers, closest name match first."
},
"next_page_token": {
"type": [
"string",
"null"
],
"description": "Pass as page_token for the next page; null on the last page."
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "adlib_meta_find_advertisers",
"title": "Find a brand on Meta",
"description": "Turns a brand or company name into the Facebook Page behind its Meta ads: each row's page_id is what adlib_meta_advertiser_ads takes, with the page_name, categories, verification and follower count, so you can tell the real brand from look-alikes. Pass query and, when you know the market, countries. The lookup is best effort: when it finds nothing for a niche or ambiguous name, run adlib_meta_search in the brand's country and read page_id off its rows, or use a Facebook Page id the user knows. Page on with next_page_token as page_token.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Brand or company name to look up its advertiser page id(s)."
},
"countries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"minItems": 1,
"description": "Two-letter ISO country codes to scope results, e.g. [\"US\",\"GB\"]. Omit for all countries. Scoping every code to the EU-27, EEA (Iceland/Liechtenstein/Norway), or UK (GB) unlocks Meta's official first-party fields (audience reach, targeting, payer)."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, at most 100. Defaults to 25."
},
"page_token": {
"type": "string",
"minLength": 1,
"description": "next_page_token from a previous call, to read the next page."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"rows",
"next_page_token"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"likes": {
"type": [
"number",
"null"
],
"description": "The Page's likes."
},
"page_id": {
"type": [
"string",
"null"
],
"description": "The advertiser's Facebook Page id, what adlib_meta_advertiser_ads takes."
},
"verified": {
"type": [
"boolean",
"null"
],
"description": "Whether Meta verified the Page."
},
"page_name": {
"type": [
"string",
"null"
],
"description": "The Facebook Page's name."
},
"ig_username": {
"type": [
"string",
"null"
],
"description": "The linked Instagram account."
},
"ig_followers": {
"type": [
"number",
"null"
],
"description": "Followers of that Instagram account."
},
"page_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "The Page's categories, e.g. Clothing store."
}
},
"additionalProperties": {}
},
"description": "This page of advertisers, closest name match first."
},
"next_page_token": {
"type": [
"string",
"null"
],
"description": "Pass as page_token for the next page; null on the last page."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Find a brand on Meta",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Every ad one advertiser runs or has run on Facebook and Instagram, from Meta's public Ad Library: the core of a competitor creative review. page_id comes from adlib_meta_find_advertisers, an adlib_meta_search row, or a Facebook Page id the user knows; narrow with countries and ad_active_status (active, inactive or all). Rows carry the ad text (cut at 2,000 characters and marked body_truncated; adlib_meta_ad_detail has the whole text), headline, call to action, media, platforms and run dates, with up to 12 thumbnails inline: read how long an ad has run as a sign it works for them. EU, EEA or UK country scopes add Meta's reach, targeting and payer fields (data_source "official"). No spend or impressions are published for commercial ads. Media links expire within hours. Page on with next_page_token as page_token.
The description explains the capability, when to use it, and what to expect.
Inputs83/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page_id
The advertiser page id, from adlib_meta_find_advertisers.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
countries
Two-letter ISO country codes to scope results, e.g. ["US","GB"]. Omit for all countries. Scoping every code to the EU-27, EEA (Iceland/Liechtenstein/Norway), or UK (GB) unlocks Meta's official first-party fields (audience reach, targeting, payer).
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
ad_active_status
Filter by delivery status: 'active', 'inactive', or 'all'.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
include_thumbnail_data
Set true to receive each thumbnail as a data: URI (thumbnail_data_uri) instead of an inline preview. Adds roughly 10-20 KB per ad.
Clear enough to supply this argument.
page_size
Rows per page, at most 100. Defaults to 25.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page_token
next_page_token from a previous call, to read the next page.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "List one advertiser's Meta ads",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
Output schema90/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"rows",
"next_page_token"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"media": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "image or video."
},
"image_url": {
"type": [
"string",
"null"
],
"description": "The full-size image."
},
"video_url": {
"type": [
"string",
"null"
],
"description": "The video file."
},
"poster_url": {
"type": [
"string",
"null"
],
"description": "The video's cover image."
},
"thumbnail_data_uri": {
"type": [
"string",
"null"
],
"description": "The thumbnail as a data: URI, only with include_thumbnail_data."
}
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "The ad's images and videos."
},
"reach": {
"type": [
"number",
"null"
],
"description": "People reached, where Meta publishes it."
},
"spend": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Spend as a range, only for ads Meta publishes it for (political and issue ads). Commercial ads have none."
},
"page_id": {
"type": [
"string",
"null"
],
"description": "The advertiser's Facebook Page id, what adlib_meta_advertiser_ads takes."
},
"creative": {
"anyOf": [
{
"type": "object",
"properties": {
"body": {
"type": [
"string",
"null"
],
"description": "The ad's primary text."
},
"cta_type": {
"type": [
"string",
"null"
],
"description": "The call to action button, e.g. SHOP_NOW."
},
"headline": {
"type": [
"string",
"null"
],
"description": "The headline under the media."
},
"link_url": {
"type": [
"string",
"null"
],
"description": "Where the ad sends people."
},
"body_truncated": {
"type": [
"boolean",
"null"
],
"description": "true when a list cut the text to its start; adlib_meta_ad_detail returns all of it."
}
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The ad's copy and destination."
},
"end_date": {
"type": [
"string",
"null"
],
"description": "The day it stopped, or null while it runs."
},
"countries": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Countries it delivered to, as two-letter codes; null when unknown."
},
"is_active": {
"type": [
"boolean",
"null"
],
"description": "Whether it is running now."
},
"page_name": {
"type": [
"string",
"null"
],
"description": "The Facebook Page's name."
},
"start_date": {
"type": [
"string",
"null"
],
"description": "The day it started running."
},
"data_source": {
"type": [
"string",
"null"
],
"description": "official for Meta's own fields (ads scoped to the EU, EEA or UK), web otherwise."
},
"impressions": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Impressions as a range, only for ads Meta publishes them for (political and issue ads)."
},
"target_ages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Targeted age range (official ads only)."
},
"ad_archive_id": {
"type": [
"string",
"null"
],
"description": "The ad's id in the Ad Library, what adlib_meta_ad_detail takes."
},
"target_gender": {
"type": [
"string",
"null"
],
"description": "Targeted gender (official ads only)."
},
"eu_total_reach": {
"type": [
"number",
"null"
],
"description": "People reached in the EU (official ads only)."
},
"page_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "The Page's categories, e.g. Clothing store."
},
"target_locations": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Targeted locations (official ads only)."
},
"beneficiary_payers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Who benefits from and who pays for the ad (official ads only)."
},
"publisher_platforms": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Where it runs: facebook, instagram, messenger, audience_network."
},
"age_country_gender_reach_breakdown": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Reach by age, country and gender (official ads only)."
}
},
"additionalProperties": {}
},
"description": "This page of ads."
},
"next_page_token": {
"type": [
"string",
"null"
],
"description": "Pass as page_token for the next page; null on the last page."
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "adlib_meta_advertiser_ads",
"title": "List one advertiser's Meta ads",
"description": "Every ad one advertiser runs or has run on Facebook and Instagram, from Meta's public Ad Library: the core of a competitor creative review. page_id comes from adlib_meta_find_advertisers, an adlib_meta_search row, or a Facebook Page id the user knows; narrow with countries and ad_active_status (active, inactive or all). Rows carry the ad text (cut at 2,000 characters and marked body_truncated; adlib_meta_ad_detail has the whole text), headline, call to action, media, platforms and run dates, with up to 12 thumbnails inline: read how long an ad has run as a sign it works for them. EU, EEA or UK country scopes add Meta's reach, targeting and payer fields (data_source \"official\"). No spend or impressions are published for commercial ads. Media links expire within hours. Page on with next_page_token as page_token.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"page_id"
],
"properties": {
"page_id": {
"type": "string",
"minLength": 1,
"description": "The advertiser page id, from adlib_meta_find_advertisers."
},
"countries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"minItems": 1,
"description": "Two-letter ISO country codes to scope results, e.g. [\"US\",\"GB\"]. Omit for all countries. Scoping every code to the EU-27, EEA (Iceland/Liechtenstein/Norway), or UK (GB) unlocks Meta's official first-party fields (audience reach, targeting, payer)."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, at most 100. Defaults to 25."
},
"page_token": {
"type": "string",
"minLength": 1,
"description": "next_page_token from a previous call, to read the next page."
},
"ad_active_status": {
"enum": [
"active",
"inactive",
"all"
],
"type": "string",
"description": "Filter by delivery status: 'active', 'inactive', or 'all'."
},
"include_thumbnail_data": {
"type": "boolean",
"description": "Set true to receive each thumbnail as a data: URI (thumbnail_data_uri) instead of an inline preview. Adds roughly 10-20 KB per ad."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"rows",
"next_page_token"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"media": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "image or video."
},
"image_url": {
"type": [
"string",
"null"
],
"description": "The full-size image."
},
"video_url": {
"type": [
"string",
"null"
],
"description": "The video file."
},
"poster_url": {
"type": [
"string",
"null"
],
"description": "The video's cover image."
},
"thumbnail_data_uri": {
"type": [
"string",
"null"
],
"description": "The thumbnail as a data: URI, only with include_thumbnail_data."
}
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "The ad's images and videos."
},
"reach": {
"type": [
"number",
"null"
],
"description": "People reached, where Meta publishes it."
},
"spend": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Spend as a range, only for ads Meta publishes it for (political and issue ads). Commercial ads have none."
},
"page_id": {
"type": [
"string",
"null"
],
"description": "The advertiser's Facebook Page id, what adlib_meta_advertiser_ads takes."
},
"creative": {
"anyOf": [
{
"type": "object",
"properties": {
"body": {
"type": [
"string",
"null"
],
"description": "The ad's primary text."
},
"cta_type": {
"type": [
"string",
"null"
],
"description": "The call to action button, e.g. SHOP_NOW."
},
"headline": {
"type": [
"string",
"null"
],
"description": "The headline under the media."
},
"link_url": {
"type": [
"string",
"null"
],
"description": "Where the ad sends people."
},
"body_truncated": {
"type": [
"boolean",
"null"
],
"description": "true when a list cut the text to its start; adlib_meta_ad_detail returns all of it."
}
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The ad's copy and destination."
},
"end_date": {
"type": [
"string",
"null"
],
"description": "The day it stopped, or null while it runs."
},
"countries": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Countries it delivered to, as two-letter codes; null when unknown."
},
"is_active": {
"type": [
"boolean",
"null"
],
"description": "Whether it is running now."
},
"page_name": {
"type": [
"string",
"null"
],
"description": "The Facebook Page's name."
},
"start_date": {
"type": [
"string",
"null"
],
"description": "The day it started running."
},
"data_source": {
"type": [
"string",
"null"
],
"description": "official for Meta's own fields (ads scoped to the EU, EEA or UK), web otherwise."
},
"impressions": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Impressions as a range, only for ads Meta publishes them for (political and issue ads)."
},
"target_ages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Targeted age range (official ads only)."
},
"ad_archive_id": {
"type": [
"string",
"null"
],
"description": "The ad's id in the Ad Library, what adlib_meta_ad_detail takes."
},
"target_gender": {
"type": [
"string",
"null"
],
"description": "Targeted gender (official ads only)."
},
"eu_total_reach": {
"type": [
"number",
"null"
],
"description": "People reached in the EU (official ads only)."
},
"page_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "The Page's categories, e.g. Clothing store."
},
"target_locations": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Targeted locations (official ads only)."
},
"beneficiary_payers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Who benefits from and who pays for the ad (official ads only)."
},
"publisher_platforms": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Where it runs: facebook, instagram, messenger, audience_network."
},
"age_country_gender_reach_breakdown": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Reach by age, country and gender (official ads only)."
}
},
"additionalProperties": {}
},
"description": "This page of ads."
},
"next_page_token": {
"type": [
"string",
"null"
],
"description": "Pass as page_token for the next page; null on the last page."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List one advertiser's Meta ads",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description93/100
The full creative of one Meta ad by its ad_archive_id from adlib_meta_search or adlib_meta_advertiser_ads: text, headline, call to action, media, the advertiser's page, platforms, run dates and countries, with the image inline. Use it for the visual of an ad that came back on the official EU path, whose rows have reach and targeting but no media. Null when no ad has that id. Its rows come from the web (data_source "web") without reach or targeting: for those, list the ads with an EU, EEA or UK country scope. Media links expire within hours.
The description explains the capability, when to use it, and what to expect.
Inputs88/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
ad_archive_id
The ad's archive id, from adlib_meta_search or adlib_meta_advertiser_ads.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
include_thumbnail_data
Set true to receive each thumbnail as a data: URI (thumbnail_data_uri) instead of an inline preview. Adds roughly 10-20 KB per ad.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "Open one Meta ad",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
Output schema80/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"object"
],
"properties": {
"object": {
"anyOf": [
{
"type": "object",
"properties": {
"media": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "image or video."
},
"image_url": {
"type": [
"string",
"null"
],
"description": "The full-size image."
},
"video_url": {
"type": [
"string",
"null"
],
"description": "The video file."
},
"poster_url": {
"type": [
"string",
"null"
],
"description": "The video's cover image."
},
"thumbnail_data_uri": {
"type": [
"string",
"null"
],
"description": "The thumbnail as a data: URI, only with include_thumbnail_data."
}
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "The ad's images and videos."
},
"reach": {
"type": [
"number",
"null"
],
"description": "People reached, where Meta publishes it."
},
"spend": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Spend as a range, only for ads Meta publishes it for (political and issue ads). Commercial ads have none."
},
"page_id": {
"type": [
"string",
"null"
],
"description": "The advertiser's Facebook Page id, what adlib_meta_advertiser_ads takes."
},
"creative": {
"anyOf": [
{
"type": "object",
"properties": {
"body": {
"type": [
"string",
"null"
],
"description": "The ad's primary text."
},
"cta_type": {
"type": [
"string",
"null"
],
"description": "The call to action button, e.g. SHOP_NOW."
},
"headline": {
"type": [
"string",
"null"
],
"description": "The headline under the media."
},
"link_url": {
"type": [
"string",
"null"
],
"description": "Where the ad sends people."
},
"body_truncated": {
"type": [
"boolean",
"null"
],
"description": "true when a list cut the text to its start; adlib_meta_ad_detail returns all of it."
}
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The ad's copy and destination."
},
"end_date": {
"type": [
"string",
"null"
],
"description": "The day it stopped, or null while it runs."
},
"countries": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Countries it delivered to, as two-letter codes; null when unknown."
},
"is_active": {
"type": [
"boolean",
"null"
],
"description": "Whether it is running now."
},
"page_name": {
"type": [
"string",
"null"
],
"description": "The Facebook Page's name."
},
"start_date": {
"type": [
"string",
"null"
],
"description": "The day it started running."
},
"data_source": {
"type": [
"string",
"null"
],
"description": "official for Meta's own fields (ads scoped to the EU, EEA or UK), web otherwise."
},
"impressions": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Impressions as a range, only for ads Meta publishes them for (political and issue ads)."
},
"target_ages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Targeted age range (official ads only)."
},
"ad_archive_id": {
"type": [
"string",
"null"
],
"description": "The ad's id in the Ad Library, what adlib_meta_ad_detail takes."
},
"target_gender": {
"type": [
"string",
"null"
],
"description": "Targeted gender (official ads only)."
},
"eu_total_reach": {
"type": [
"number",
"null"
],
"description": "People reached in the EU (official ads only)."
},
"page_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "The Page's categories, e.g. Clothing store."
},
"target_locations": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Targeted locations (official ads only)."
},
"beneficiary_payers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Who benefits from and who pays for the ad (official ads only)."
},
"publisher_platforms": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Where it runs: facebook, instagram, messenger, audience_network."
},
"age_country_gender_reach_breakdown": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Reach by age, country and gender (official ads only)."
}
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The ad, or null when no ad has this id."
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "adlib_meta_ad_detail",
"title": "Open one Meta ad",
"description": "The full creative of one Meta ad by its ad_archive_id from adlib_meta_search or adlib_meta_advertiser_ads: text, headline, call to action, media, the advertiser's page, platforms, run dates and countries, with the image inline. Use it for the visual of an ad that came back on the official EU path, whose rows have reach and targeting but no media. Null when no ad has that id. Its rows come from the web (data_source \"web\") without reach or targeting: for those, list the ads with an EU, EEA or UK country scope. Media links expire within hours.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ad_archive_id"
],
"properties": {
"ad_archive_id": {
"type": "string",
"minLength": 1,
"description": "The ad's archive id, from adlib_meta_search or adlib_meta_advertiser_ads."
},
"include_thumbnail_data": {
"type": "boolean",
"description": "Set true to receive each thumbnail as a data: URI (thumbnail_data_uri) instead of an inline preview. Adds roughly 10-20 KB per ad."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"object"
],
"properties": {
"object": {
"anyOf": [
{
"type": "object",
"properties": {
"media": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "image or video."
},
"image_url": {
"type": [
"string",
"null"
],
"description": "The full-size image."
},
"video_url": {
"type": [
"string",
"null"
],
"description": "The video file."
},
"poster_url": {
"type": [
"string",
"null"
],
"description": "The video's cover image."
},
"thumbnail_data_uri": {
"type": [
"string",
"null"
],
"description": "The thumbnail as a data: URI, only with include_thumbnail_data."
}
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "The ad's images and videos."
},
"reach": {
"type": [
"number",
"null"
],
"description": "People reached, where Meta publishes it."
},
"spend": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Spend as a range, only for ads Meta publishes it for (political and issue ads). Commercial ads have none."
},
"page_id": {
"type": [
"string",
"null"
],
"description": "The advertiser's Facebook Page id, what adlib_meta_advertiser_ads takes."
},
"creative": {
"anyOf": [
{
"type": "object",
"properties": {
"body": {
"type": [
"string",
"null"
],
"description": "The ad's primary text."
},
"cta_type": {
"type": [
"string",
"null"
],
"description": "The call to action button, e.g. SHOP_NOW."
},
"headline": {
"type": [
"string",
"null"
],
"description": "The headline under the media."
},
"link_url": {
"type": [
"string",
"null"
],
"description": "Where the ad sends people."
},
"body_truncated": {
"type": [
"boolean",
"null"
],
"description": "true when a list cut the text to its start; adlib_meta_ad_detail returns all of it."
}
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The ad's copy and destination."
},
"end_date": {
"type": [
"string",
"null"
],
"description": "The day it stopped, or null while it runs."
},
"countries": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Countries it delivered to, as two-letter codes; null when unknown."
},
"is_active": {
"type": [
"boolean",
"null"
],
"description": "Whether it is running now."
},
"page_name": {
"type": [
"string",
"null"
],
"description": "The Facebook Page's name."
},
"start_date": {
"type": [
"string",
"null"
],
"description": "The day it started running."
},
"data_source": {
"type": [
"string",
"null"
],
"description": "official for Meta's own fields (ads scoped to the EU, EEA or UK), web otherwise."
},
"impressions": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Impressions as a range, only for ads Meta publishes them for (political and issue ads)."
},
"target_ages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Targeted age range (official ads only)."
},
"ad_archive_id": {
"type": [
"string",
"null"
],
"description": "The ad's id in the Ad Library, what adlib_meta_ad_detail takes."
},
"target_gender": {
"type": [
"string",
"null"
],
"description": "Targeted gender (official ads only)."
},
"eu_total_reach": {
"type": [
"number",
"null"
],
"description": "People reached in the EU (official ads only)."
},
"page_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "The Page's categories, e.g. Clothing store."
},
"target_locations": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Targeted locations (official ads only)."
},
"beneficiary_payers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Who benefits from and who pays for the ad (official ads only)."
},
"publisher_platforms": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Where it runs: facebook, instagram, messenger, audience_network."
},
"age_country_gender_reach_breakdown": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "Reach by age, country and gender (official ads only)."
}
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The ad, or null when no ad has this id."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Open one Meta ad",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
Looks up which advertisers Google's Ads Transparency Center lists for a brand or keyword, with each one's advertiser id and domain: the first step before adlib_google_advertiser_ads shows their ads. Pass one keyword, and location and language for the market (ask the user rather than assume worldwide); limit caps how many advertisers come back. Rows are paged: result_id with page and page_size reads more of the same result without a new lookup, and leaves out keyword, location and language.
The description explains the capability, when to use it, and what to expect.
Inputs93/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
keyword
The keyword or brand term to find advertisers for. Example: "running shoes".
Clear enough to supply this argument.
location
Country for the advertiser lookup (e.g. "United States", "Germany", "France"). Specify the intended search-market country; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user; do not omit location or assume worldwide on fresh searches. Omit when paging with result_id.
Clear enough to supply this argument.
language
Language for the advertiser lookup (e.g. "English", "German", "French"). Specify the intended search language; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user. Omit when paging with result_id.
Clear enough to supply this argument.
limit
Maximum number of results to return. The data source ignores small counts and may return many more, so set this to cap the total (e.g. 20). Defaults to the provider's full set.
Clear enough to supply this argument.
page
Page number to return. Defaults to 1.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page_size
Rows per page to return. Defaults to 10.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
result_id
Result ID returned by a previous call to this research tool. Valid for 24 hours; use for stored pages without a fresh provider request. After expiry, start a fresh lookup.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"required": [
"expires_at",
"page",
"page_size",
"result_id",
"row_count",
"total_pages",
"rows"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "This page's number."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "What the row is: ads_advertiser, ads_multi_account_advertiser or ads_domain."
},
"title": {
"type": [
"string",
"null"
],
"description": "The advertiser's name."
},
"domain": {
"type": [
"string",
"null"
],
"description": "For ads_domain rows: the advertised domain."
},
"location": {
"type": [
"string",
"null"
],
"description": "The advertiser's country."
},
"verified": {
"type": [
"boolean",
"null"
],
"description": "Whether Google verified the advertiser."
},
"rank_group": {
"type": [
"number",
"null"
],
"description": "Its position among rows of the same type."
},
"advertisers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": [
"string",
"null"
],
"description": "The account's country."
},
"verified": {
"type": [
"boolean",
"null"
],
"description": "Whether Google verified the account."
},
"advertiser_id": {
"type": [
"string",
"null"
],
"description": "The account's id."
},
"approx_ads_count": {
"type": [
"number",
"null"
],
"description": "Roughly how many ads the account has run."
}
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "For ads_multi_account_advertiser rows: the accounts behind one name."
},
"advertiser_id": {
"type": [
"string",
"null"
],
"description": "The advertiser account's id, what adlib_google_advertiser_ads takes in advertiser_ids."
},
"rank_absolute": {
"type": [
"number",
"null"
],
"description": "Its position among all rows."
},
"approx_ads_count": {
"type": [
"number",
"null"
],
"description": "Roughly how many ads it has run on Google."
}
},
"additionalProperties": {}
},
"description": "This page's advertisers, best match first."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "The stored result. With page and page_size, reads another page without a new lookup."
},
"row_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows in the whole result, across all pages."
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the stored result expires. Until then result_id reads its other pages for free."
},
"total_pages": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Pages in the whole result at this page_size."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "adlib_google_find_advertisers",
"title": "Find advertisers on Google",
"description": "Looks up which advertisers Google's Ads Transparency Center lists for a brand or keyword, with each one's advertiser id and domain: the first step before adlib_google_advertiser_ads shows their ads. Pass one keyword, and location and language for the market (ask the user rather than assume worldwide); limit caps how many advertisers come back. Rows are paged: result_id with page and page_size reads more of the same result without a new lookup, and leaves out keyword, location and language.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number to return. Defaults to 1."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum number of results to return. The data source ignores small counts and may return many more, so set this to cap the total (e.g. 20). Defaults to the provider's full set."
},
"keyword": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The keyword or brand term to find advertisers for. Example: \"running shoes\"."
},
"language": {
"type": "string",
"minLength": 1,
"description": "Language for the advertiser lookup (e.g. \"English\", \"German\", \"French\"). Specify the intended search language; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user. Omit when paging with result_id."
},
"location": {
"type": "string",
"minLength": 1,
"description": "Country for the advertiser lookup (e.g. \"United States\", \"Germany\", \"France\"). Specify the intended search-market country; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user; do not omit location or assume worldwide on fresh searches. Omit when paging with result_id."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page to return. Defaults to 10."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "Result ID returned by a previous call to this research tool. Valid for 24 hours; use for stored pages without a fresh provider request. After expiry, start a fresh lookup."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"required": [
"expires_at",
"page",
"page_size",
"result_id",
"row_count",
"total_pages",
"rows"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "This page's number."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "What the row is: ads_advertiser, ads_multi_account_advertiser or ads_domain."
},
"title": {
"type": [
"string",
"null"
],
"description": "The advertiser's name."
},
"domain": {
"type": [
"string",
"null"
],
"description": "For ads_domain rows: the advertised domain."
},
"location": {
"type": [
"string",
"null"
],
"description": "The advertiser's country."
},
"verified": {
"type": [
"boolean",
"null"
],
"description": "Whether Google verified the advertiser."
},
"rank_group": {
"type": [
"number",
"null"
],
"description": "Its position among rows of the same type."
},
"advertisers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": [
"string",
"null"
],
"description": "The account's country."
},
"verified": {
"type": [
"boolean",
"null"
],
"description": "Whether Google verified the account."
},
"advertiser_id": {
"type": [
"string",
"null"
],
"description": "The account's id."
},
"approx_ads_count": {
"type": [
"number",
"null"
],
"description": "Roughly how many ads the account has run."
}
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "For ads_multi_account_advertiser rows: the accounts behind one name."
},
"advertiser_id": {
"type": [
"string",
"null"
],
"description": "The advertiser account's id, what adlib_google_advertiser_ads takes in advertiser_ids."
},
"rank_absolute": {
"type": [
"number",
"null"
],
"description": "Its position among all rows."
},
"approx_ads_count": {
"type": [
"number",
"null"
],
"description": "Roughly how many ads it has run on Google."
}
},
"additionalProperties": {}
},
"description": "This page's advertisers, best match first."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "The stored result. With page and page_size, reads another page without a new lookup."
},
"row_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows in the whole result, across all pages."
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the stored result expires. Until then result_id reads its other pages for free."
},
"total_pages": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Pages in the whole result at this page_size."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"title": "Find advertisers on Google",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
The ads one advertiser runs or has run on Google, most recently shown first, from the Ads Transparency Center, across Search, YouTube, Shopping, Maps and Play. Each row has the format, first_shown and last_shown, and a preview image or preview_url, but not the ad text. Name the advertiser by exactly one of target, their domain ("acme.com"), or advertiser_ids from adlib_google_find_advertisers; this tool has no keyword search, and the ads shown on a search query are adlib_google_keyword_ads. Narrow with platform (google_search, google_shopping, google_maps, google_play or all) and format (text, image, video or all); YouTube has no platform filter of its own, its ads are among format video, and give location and language for the market. Rows are paged: result_id with page and page_size reads more of the same result without a new lookup.
The description explains the capability, when to use it, and what to expect.
Inputs81/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
target
The advertiser domain whose live ads to fetch, with no scheme or path. Example: "acme.com". For a new search provide exactly one of target or advertiser_ids; omit both when paging with result_id.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
advertiser_ids
Advertiser identifiers returned by adlib_google_find_advertisers (max 25). For a new search provide exactly one of target or advertiser_ids; omit both when paging with result_id.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
platform
Filter ads to one platform: 'google_search', 'google_shopping', 'google_maps', 'google_play', or 'all'. YouTube cannot be picked on its own: its ads are among format 'video'.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
format
Filter ads to one creative format: 'text', 'image', 'video', or 'all'.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
location
Country for the ad search (e.g. "United States", "Germany", "France"). Specify the intended search-market country; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user; do not omit location or assume worldwide on fresh searches. Omit when paging with result_id.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
language
Language for the ad search (e.g. "English", "German", "French"). Specify the intended search language; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user. Omit when paging with result_id.
Clear enough to supply this argument.
page
Page number to return. Defaults to 1.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page_size
Rows per page to return. Defaults to 10.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
result_id
Result ID returned by a previous call to this research tool. Valid for 24 hours; use for stored pages without a fresh provider request. After expiry, start a fresh lookup.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "List one advertiser's Google ads",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
Output schema73/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"required": [
"expires_at",
"page",
"page_size",
"result_id",
"row_count",
"total_pages",
"rows"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "This page's number."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "The ad's page in the Ads Transparency Center."
},
"type": {
"type": [
"string",
"null"
],
"description": "Always ads_search."
},
"title": {
"type": [
"string",
"null"
],
"description": "The advertiser's name."
},
"format": {
"type": [
"string",
"null"
],
"description": "text, image or video."
},
"verified": {
"type": [
"boolean",
"null"
],
"description": "Whether Google verified the advertiser."
},
"last_shown": {
"type": [
"string",
"null"
],
"description": "When Google last showed it (UTC)."
},
"rank_group": {
"type": [
"number",
"null"
],
"description": "Its position in the list."
},
"creative_id": {
"type": [
"string",
"null"
],
"description": "The ad's id."
},
"first_shown": {
"type": [
"string",
"null"
],
"description": "When Google first showed it (UTC)."
},
"preview_url": {
"type": [
"string",
"null"
],
"description": "A page that renders the ad, when there is no image."
},
"advertiser_id": {
"type": [
"string",
"null"
],
"description": "The advertiser account that runs it."
},
"preview_image": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "The preview image."
},
"width": {
"type": [
"number",
"null"
],
"description": "Its width in pixels."
},
"height": {
"type": [
"number",
"null"
],
"description": "Its height in pixels."
}
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "A picture of the ad, when Google has one."
},
"rank_absolute": {
"type": [
"number",
"null"
],
"description": "Its position in the list."
}
},
"additionalProperties": {}
},
"description": "This page's ads, most recently shown first."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "The stored result. With page and page_size, reads another page without a new lookup."
},
"row_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows in the whole result, across all pages."
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the stored result expires. Until then result_id reads its other pages for free."
},
"total_pages": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Pages in the whole result at this page_size."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "adlib_google_advertiser_ads",
"title": "List one advertiser's Google ads",
"description": "The ads one advertiser runs or has run on Google, most recently shown first, from the Ads Transparency Center, across Search, YouTube, Shopping, Maps and Play. Each row has the format, first_shown and last_shown, and a preview image or preview_url, but not the ad text. Name the advertiser by exactly one of target, their domain (\"acme.com\"), or advertiser_ids from adlib_google_find_advertisers; this tool has no keyword search, and the ads shown on a search query are adlib_google_keyword_ads. Narrow with platform (google_search, google_shopping, google_maps, google_play or all) and format (text, image, video or all); YouTube has no platform filter of its own, its ads are among format video, and give location and language for the market. Rows are paged: result_id with page and page_size reads more of the same result without a new lookup.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number to return. Defaults to 1."
},
"format": {
"enum": [
"all",
"text",
"image",
"video"
],
"type": "string",
"description": "Filter ads to one creative format: 'text', 'image', 'video', or 'all'."
},
"target": {
"type": "string",
"maxLength": 253,
"minLength": 1,
"description": "The advertiser domain whose live ads to fetch, with no scheme or path. Example: \"acme.com\". For a new search provide exactly one of target or advertiser_ids; omit both when paging with result_id."
},
"language": {
"type": "string",
"minLength": 1,
"description": "Language for the ad search (e.g. \"English\", \"German\", \"French\"). Specify the intended search language; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user. Omit when paging with result_id."
},
"location": {
"type": "string",
"minLength": 1,
"description": "Country for the ad search (e.g. \"United States\", \"Germany\", \"France\"). Specify the intended search-market country; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user; do not omit location or assume worldwide on fresh searches. Omit when paging with result_id."
},
"platform": {
"enum": [
"all",
"google_play",
"google_maps",
"google_search",
"google_shopping"
],
"type": "string",
"description": "Filter ads to one platform: 'google_search', 'google_shopping', 'google_maps', 'google_play', or 'all'. YouTube cannot be picked on its own: its ads are among format 'video'."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page to return. Defaults to 10."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "Result ID returned by a previous call to this research tool. Valid for 24 hours; use for stored pages without a fresh provider request. After expiry, start a fresh lookup."
},
"advertiser_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 25,
"minItems": 1,
"description": "Advertiser identifiers returned by adlib_google_find_advertisers (max 25). For a new search provide exactly one of target or advertiser_ids; omit both when paging with result_id."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"required": [
"expires_at",
"page",
"page_size",
"result_id",
"row_count",
"total_pages",
"rows"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "This page's number."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "The ad's page in the Ads Transparency Center."
},
"type": {
"type": [
"string",
"null"
],
"description": "Always ads_search."
},
"title": {
"type": [
"string",
"null"
],
"description": "The advertiser's name."
},
"format": {
"type": [
"string",
"null"
],
"description": "text, image or video."
},
"verified": {
"type": [
"boolean",
"null"
],
"description": "Whether Google verified the advertiser."
},
"last_shown": {
"type": [
"string",
"null"
],
"description": "When Google last showed it (UTC)."
},
"rank_group": {
"type": [
"number",
"null"
],
"description": "Its position in the list."
},
"creative_id": {
"type": [
"string",
"null"
],
"description": "The ad's id."
},
"first_shown": {
"type": [
"string",
"null"
],
"description": "When Google first showed it (UTC)."
},
"preview_url": {
"type": [
"string",
"null"
],
"description": "A page that renders the ad, when there is no image."
},
"advertiser_id": {
"type": [
"string",
"null"
],
"description": "The advertiser account that runs it."
},
"preview_image": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "The preview image."
},
"width": {
"type": [
"number",
"null"
],
"description": "Its width in pixels."
},
"height": {
"type": [
"number",
"null"
],
"description": "Its height in pixels."
}
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "A picture of the ad, when Google has one."
},
"rank_absolute": {
"type": [
"number",
"null"
],
"description": "Its position in the list."
}
},
"additionalProperties": {}
},
"description": "This page's ads, most recently shown first."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "The stored result. With page and page_size, reads another page without a new lookup."
},
"row_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows in the whole result, across all pages."
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the stored result expires. Until then result_id reads its other pages for free."
},
"total_pages": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Pages in the whole result at this page_size."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"title": "List one advertiser's Google ads",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description92/100
The sponsored results Google shows for one search query right now, each with the advertiser's domain, headline, text and position: who bids on a keyword and what they say. Pass keyword, location and language for the market (ask the user rather than assume worldwide) and, optionally, device (desktop or mobile). No ads means nobody bid in that market at that moment, not that nobody ever does. Rows are paged: result_id with page and page_size reads more of the same result without a new lookup. Results combine Google data with third-party data.
The description explains the capability, when to use it, and what to expect.
Inputs89/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
keyword
The single search query to pull SERP results for. Example: "bilan de compétences CPF". Required for a new search; omit when paging with result_id.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
location
Country for the SERP (e.g. "United States", "Germany", "France"). Specify the intended search-market country; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user; do not omit location or assume worldwide on fresh searches. Omit when paging with result_id.
Clear enough to supply this argument.
language
Language for the SERP (e.g. "English", "German", "French"). Specify the intended search language; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user. Omit when paging with result_id.
Clear enough to supply this argument.
device
Device to emulate for the SERP. Defaults to desktop.
Clear enough to supply this argument.
page
Page number to return. Defaults to 1.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page_size
Rows per page to return. Defaults to 10.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
result_id
Result ID returned by a previous call to this research tool. Valid for 24 hours; use for stored pages without a fresh provider request. After expiry, start a fresh lookup.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "See who advertises on a Google search",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
Output schema70/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"required": [
"expires_at",
"page",
"page_size",
"result_id",
"row_count",
"total_pages",
"rows"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "This page's number."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"items": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "The page it links to."
},
"type": {
"type": [
"string",
"null"
],
"description": "What the entry is: paid, organic, people_also_ask and so on."
},
"title": {
"type": [
"string",
"null"
],
"description": "The headline."
},
"domain": {
"type": [
"string",
"null"
],
"description": "The site it links to."
},
"position": {
"type": [
"string",
"null"
],
"description": "left or right side of the page."
},
"breadcrumb": {
"type": [
"string",
"null"
],
"description": "The URL path Google shows."
},
"rank_group": {
"type": [
"number",
"null"
],
"description": "Its position among entries of the same type."
},
"description": {
"type": [
"string",
"null"
],
"description": "The text under the headline."
},
"website_name": {
"type": [
"string",
"null"
],
"description": "The site's name as Google shows it."
},
"rank_absolute": {
"type": [
"number",
"null"
],
"description": "Its position on the whole page."
}
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "The page's entries in order; each type adds its own fields (links, price, rating on paid ads)."
},
"keyword": {
"type": [
"string",
"null"
],
"description": "The search query."
},
"datetime": {
"type": [
"string",
"null"
],
"description": "When the page was read (UTC)."
},
"check_url": {
"type": [
"string",
"null"
],
"description": "The same search on Google, to check by hand."
},
"item_types": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "The entry types on the page."
},
"items_count": {
"type": [
"number",
"null"
],
"description": "Entries in items."
},
"se_results_count": {
"type": [
"number",
"null"
],
"description": "Google's estimate of all results for the query."
}
},
"additionalProperties": {}
},
"description": "The results page as Google returned it, its entries in items."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "The stored result. With page and page_size, reads another page without a new lookup."
},
"row_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows in the whole result, across all pages."
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the stored result expires. Until then result_id reads its other pages for free."
},
"ai_overview": {
"type": "object",
"required": [
"present",
"text",
"references"
],
"properties": {
"text": {
"type": [
"string",
"null"
],
"description": "The summary's text."
},
"present": {
"type": "boolean",
"description": "Whether the page shows an AI summary."
},
"references": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"title",
"url"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "The cited page."
},
"title": {
"type": [
"string",
"null"
],
"description": "The cited page's title."
},
"domain": {
"type": [
"string",
"null"
],
"description": "The cited site."
}
},
"additionalProperties": false
},
"description": "Sources the summary cites."
},
"cites_domain": {
"type": "boolean",
"description": "With citedDomain: whether a source is on it."
}
},
"description": "The AI summary on the results page, when asked for.",
"additionalProperties": false
},
"total_pages": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Pages in the whole result at this page_size."
},
"people_also_ask": {
"type": "array",
"items": {
"type": "object",
"required": [
"question",
"answer",
"url",
"domain"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "The answer's source page."
},
"answer": {
"type": [
"string",
"null"
],
"description": "The answer shown under it."
},
"domain": {
"type": [
"string",
"null"
],
"description": "The answer's source site."
},
"question": {
"type": "string",
"description": "The question."
}
},
"additionalProperties": false
},
"description": "People also ask questions, when asked for."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "adlib_google_keyword_ads",
"title": "See who advertises on a Google search",
"description": "The sponsored results Google shows for one search query right now, each with the advertiser's domain, headline, text and position: who bids on a keyword and what they say. Pass keyword, location and language for the market (ask the user rather than assume worldwide) and, optionally, device (desktop or mobile). No ads means nobody bid in that market at that moment, not that nobody ever does. Rows are paged: result_id with page and page_size reads more of the same result without a new lookup. Results combine Google data with third-party data.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number to return. Defaults to 1."
},
"device": {
"enum": [
"desktop",
"mobile"
],
"type": "string",
"description": "Device to emulate for the SERP. Defaults to desktop."
},
"keyword": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The single search query to pull SERP results for. Example: \"bilan de compétences CPF\". Required for a new search; omit when paging with result_id."
},
"language": {
"type": "string",
"minLength": 1,
"description": "Language for the SERP (e.g. \"English\", \"German\", \"French\"). Specify the intended search language; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user. Omit when paging with result_id."
},
"location": {
"type": "string",
"minLength": 1,
"description": "Country for the SERP (e.g. \"United States\", \"Germany\", \"France\"). Specify the intended search-market country; the server does not infer it from a Google Ads Account. Reuse known market context or ask the user; do not omit location or assume worldwide on fresh searches. Omit when paging with result_id."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page to return. Defaults to 10."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "Result ID returned by a previous call to this research tool. Valid for 24 hours; use for stored pages without a fresh provider request. After expiry, start a fresh lookup."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"required": [
"expires_at",
"page",
"page_size",
"result_id",
"row_count",
"total_pages",
"rows"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "This page's number."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"items": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "The page it links to."
},
"type": {
"type": [
"string",
"null"
],
"description": "What the entry is: paid, organic, people_also_ask and so on."
},
"title": {
"type": [
"string",
"null"
],
"description": "The headline."
},
"domain": {
"type": [
"string",
"null"
],
"description": "The site it links to."
},
"position": {
"type": [
"string",
"null"
],
"description": "left or right side of the page."
},
"breadcrumb": {
"type": [
"string",
"null"
],
"description": "The URL path Google shows."
},
"rank_group": {
"type": [
"number",
"null"
],
"description": "Its position among entries of the same type."
},
"description": {
"type": [
"string",
"null"
],
"description": "The text under the headline."
},
"website_name": {
"type": [
"string",
"null"
],
"description": "The site's name as Google shows it."
},
"rank_absolute": {
"type": [
"number",
"null"
],
"description": "Its position on the whole page."
}
},
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "The page's entries in order; each type adds its own fields (links, price, rating on paid ads)."
},
"keyword": {
"type": [
"string",
"null"
],
"description": "The search query."
},
"datetime": {
"type": [
"string",
"null"
],
"description": "When the page was read (UTC)."
},
"check_url": {
"type": [
"string",
"null"
],
"description": "The same search on Google, to check by hand."
},
"item_types": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "The entry types on the page."
},
"items_count": {
"type": [
"number",
"null"
],
"description": "Entries in items."
},
"se_results_count": {
"type": [
"number",
"null"
],
"description": "Google's estimate of all results for the query."
}
},
"additionalProperties": {}
},
"description": "The results page as Google returned it, its entries in items."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "The stored result. With page and page_size, reads another page without a new lookup."
},
"row_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows in the whole result, across all pages."
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the stored result expires. Until then result_id reads its other pages for free."
},
"ai_overview": {
"type": "object",
"required": [
"present",
"text",
"references"
],
"properties": {
"text": {
"type": [
"string",
"null"
],
"description": "The summary's text."
},
"present": {
"type": "boolean",
"description": "Whether the page shows an AI summary."
},
"references": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"title",
"url"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "The cited page."
},
"title": {
"type": [
"string",
"null"
],
"description": "The cited page's title."
},
"domain": {
"type": [
"string",
"null"
],
"description": "The cited site."
}
},
"additionalProperties": false
},
"description": "Sources the summary cites."
},
"cites_domain": {
"type": "boolean",
"description": "With citedDomain: whether a source is on it."
}
},
"description": "The AI summary on the results page, when asked for.",
"additionalProperties": false
},
"total_pages": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Pages in the whole result at this page_size."
},
"people_also_ask": {
"type": "array",
"items": {
"type": "object",
"required": [
"question",
"answer",
"url",
"domain"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "The answer's source page."
},
"answer": {
"type": [
"string",
"null"
],
"description": "The answer shown under it."
},
"domain": {
"type": [
"string",
"null"
],
"description": "The answer's source site."
},
"question": {
"type": "string",
"description": "The question."
}
},
"additionalProperties": false
},
"description": "People also ask questions, when asked for."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"title": "See who advertises on a Google search",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
The domains that compete with a site in Google's organic results, one row each: shared_keywords and avg_position on them, then the competitor's organic and paid keyword counts, estimated monthly visits (traffic) and what that traffic would cost to buy in USD. paid_keywords above 0 means it runs Google search ads, so it is a good one to look up. Large platforms such as youtube.com or reddit.com share keywords with almost any site; skip them. These are third-party estimates, not Google's or Meta's own lists. Pass domain without https:// or a path ("acme.com"), and location and language for the market; limit caps the rows. A result keeps for 24 hours: result_id with page and page_size reads more of it without a new lookup.
The description explains the capability, when to use it, and what to expect.
Inputs95/100
Remove repeated schema validation from descriptions; focus on meaning and usage context.
domain
Domain whose organic-search competitors to find, without a scheme, port, path, query, or fragment. Example: "acme.com". Required for a new lookup; omit when paging with result_id.
Clear enough to supply this argument.
location
Target search-market country for a new competitor lookup (e.g. "United States", "Germany", "France"), not the user's personal location. Reuse known Account context or ask the user if unknown; the server does not infer it from a Google Ads Account. Omit when paging with result_id.
Clear enough to supply this argument.
language
Target search language for a new competitor lookup (e.g. "English", "German", "French"). Reuse known Account context or ask the user if unknown; the server does not infer it from a Google Ads Account. Omit when paging with result_id.
Clear enough to supply this argument.
limit
Competitor domains to fetch for a new lookup. Uses the provider default if omitted. Omit when paging with result_id.
Clear enough to supply this argument.
page
Page number to return. Defaults to 1.
Clear enough to supply this argument.
page_size
Rows per page to return. Defaults to 10.
Clear enough to supply this argument.
result_id
Result ID from a previous adlib_find_competitors lookup, valid for 24 hours. With result_id, only page and page_size may also be supplied; omit domain, location, language, and limit. Omit result_id for a new lookup.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"required": [
"expires_at",
"page",
"page_size",
"result_id",
"row_count",
"total_pages",
"rows"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "This page's number."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"shared_keywords",
"avg_position",
"shared_keywords_traffic",
"organic_keywords",
"organic_traffic",
"organic_traffic_value_usd",
"paid_keywords",
"paid_traffic",
"paid_traffic_cost_usd"
],
"properties": {
"domain": {
"type": "string",
"description": "The competing site."
},
"avg_position": {
"type": [
"number",
"null"
],
"description": "Its average position on those shared keywords."
},
"paid_traffic": {
"type": [
"number",
"null"
],
"description": "Its estimated monthly paid visits."
},
"paid_keywords": {
"type": [
"number",
"null"
],
"description": "Keywords it bids on."
},
"organic_traffic": {
"type": [
"number",
"null"
],
"description": "Its estimated monthly organic visits."
},
"shared_keywords": {
"type": [
"number",
"null"
],
"description": "Keywords both sites rank for."
},
"organic_keywords": {
"type": [
"number",
"null"
],
"description": "Keywords it ranks for organically."
},
"paid_traffic_cost_usd": {
"type": [
"number",
"null"
],
"description": "Its estimated monthly ad spend for that traffic, in USD."
},
"shared_keywords_traffic": {
"type": [
"number",
"null"
],
"description": "Its estimated monthly visits from the shared keywords."
},
"organic_traffic_value_usd": {
"type": [
"number",
"null"
],
"description": "What that organic traffic would cost as ads, in USD."
}
},
"additionalProperties": {}
},
"description": "This page's competitors, one per row."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "The stored result. With page and page_size, reads another page without a new lookup."
},
"row_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows in the whole result, across all pages."
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the stored result expires. Until then result_id reads its other pages for free."
},
"total_pages": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Pages in the whole result at this page_size."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "adlib_find_competitors",
"title": "Find a site's competitors",
"description": "The domains that compete with a site in Google's organic results, one row each: shared_keywords and avg_position on them, then the competitor's organic and paid keyword counts, estimated monthly visits (traffic) and what that traffic would cost to buy in USD. paid_keywords above 0 means it runs Google search ads, so it is a good one to look up. Large platforms such as youtube.com or reddit.com share keywords with almost any site; skip them. These are third-party estimates, not Google's or Meta's own lists. Pass domain without https:// or a path (\"acme.com\"), and location and language for the market; limit caps the rows. A result keeps for 24 hours: result_id with page and page_size reads more of it without a new lookup.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number to return. Defaults to 1."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Competitor domains to fetch for a new lookup. Uses the provider default if omitted. Omit when paging with result_id."
},
"domain": {
"type": "string",
"maxLength": 253,
"minLength": 1,
"description": "Domain whose organic-search competitors to find, without a scheme, port, path, query, or fragment. Example: \"acme.com\". Required for a new lookup; omit when paging with result_id."
},
"language": {
"type": "string",
"minLength": 1,
"description": "Target search language for a new competitor lookup (e.g. \"English\", \"German\", \"French\"). Reuse known Account context or ask the user if unknown; the server does not infer it from a Google Ads Account. Omit when paging with result_id."
},
"location": {
"type": "string",
"minLength": 1,
"description": "Target search-market country for a new competitor lookup (e.g. \"United States\", \"Germany\", \"France\"), not the user's personal location. Reuse known Account context or ask the user if unknown; the server does not infer it from a Google Ads Account. Omit when paging with result_id."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page to return. Defaults to 10."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "Result ID from a previous adlib_find_competitors lookup, valid for 24 hours. With result_id, only page and page_size may also be supplied; omit domain, location, language, and limit. Omit result_id for a new lookup."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"required": [
"expires_at",
"page",
"page_size",
"result_id",
"row_count",
"total_pages",
"rows"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "This page's number."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"shared_keywords",
"avg_position",
"shared_keywords_traffic",
"organic_keywords",
"organic_traffic",
"organic_traffic_value_usd",
"paid_keywords",
"paid_traffic",
"paid_traffic_cost_usd"
],
"properties": {
"domain": {
"type": "string",
"description": "The competing site."
},
"avg_position": {
"type": [
"number",
"null"
],
"description": "Its average position on those shared keywords."
},
"paid_traffic": {
"type": [
"number",
"null"
],
"description": "Its estimated monthly paid visits."
},
"paid_keywords": {
"type": [
"number",
"null"
],
"description": "Keywords it bids on."
},
"organic_traffic": {
"type": [
"number",
"null"
],
"description": "Its estimated monthly organic visits."
},
"shared_keywords": {
"type": [
"number",
"null"
],
"description": "Keywords both sites rank for."
},
"organic_keywords": {
"type": [
"number",
"null"
],
"description": "Keywords it ranks for organically."
},
"paid_traffic_cost_usd": {
"type": [
"number",
"null"
],
"description": "Its estimated monthly ad spend for that traffic, in USD."
},
"shared_keywords_traffic": {
"type": [
"number",
"null"
],
"description": "Its estimated monthly visits from the shared keywords."
},
"organic_traffic_value_usd": {
"type": [
"number",
"null"
],
"description": "What that organic traffic would cost as ads, in USD."
}
},
"additionalProperties": {}
},
"description": "This page's competitors, one per row."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Rows per page."
},
"result_id": {
"type": "string",
"minLength": 1,
"description": "The stored result. With page and page_size, reads another page without a new lookup."
},
"row_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows in the whole result, across all pages."
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the stored result expires. Until then result_id reads its other pages for free."
},
"total_pages": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Pages in the whole result at this page_size."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"title": "Find a site's competitors",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
Opens a landing page in a real browser and returns a screenshot inline, so you can see where a competitor's ad sends people: the offer, the headline above the fold, the proof and the call to action. Pass the full url with https://. full_page captures the whole scrolling page instead of the first screen; browser_preset picks desktop (default), mobile or tablet. The image comes back as content; the structured result only records the url, full_page and browser_preset captured, so judge the page from the image itself.
The description explains the capability, when to use it, and what to expect.
Inputs83/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
url
The full landing page URL to capture, including the scheme. Example: https://acme.com/lp/spring-sale
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
full_page
Capture the entire scrollable page instead of just the viewport. Defaults to viewport only.
Clear enough to supply this argument.
browser_preset
Rendering viewport for the screenshot: 'desktop', 'mobile', or 'tablet'. Defaults to desktop.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"result",
"result_count"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"full_page",
"browser_preset"
],
"properties": {
"url": {
"type": "string",
"description": "The page captured."
},
"full_page": {
"type": "boolean",
"description": "true for the whole scrollable page, false for the viewport."
},
"browser_preset": {
"type": "string",
"description": "The viewport: desktop, mobile or tablet."
}
},
"additionalProperties": {}
},
"description": "What was captured. The screenshot itself is the image in the result's content."
},
"result_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Entries in result."
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "adlib_landing_page_screenshot",
"title": "Screenshot a landing page",
"description": "Opens a landing page in a real browser and returns a screenshot inline, so you can see where a competitor's ad sends people: the offer, the headline above the fold, the proof and the call to action. Pass the full url with https://. full_page captures the whole scrolling page instead of the first screen; browser_preset picks desktop (default), mobile or tablet. The image comes back as content; the structured result only records the url, full_page and browser_preset captured, so judge the page from the image itself.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"minLength": 1,
"description": "The full landing page URL to capture, including the scheme. Example: https://acme.com/lp/spring-sale"
},
"full_page": {
"type": "boolean",
"description": "Capture the entire scrollable page instead of just the viewport. Defaults to viewport only."
},
"browser_preset": {
"enum": [
"desktop",
"mobile",
"tablet"
],
"type": "string",
"description": "Rendering viewport for the screenshot: 'desktop', 'mobile', or 'tablet'. Defaults to desktop."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"result",
"result_count"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"full_page",
"browser_preset"
],
"properties": {
"url": {
"type": "string",
"description": "The page captured."
},
"full_page": {
"type": "boolean",
"description": "true for the whole scrollable page, false for the viewport."
},
"browser_preset": {
"type": "string",
"description": "The viewport: desktop, mobile or tablet."
}
},
"additionalProperties": {}
},
"description": "What was captured. The screenshot itself is the image in the result's content."
},
"result_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Entries in result."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Screenshot a landing page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description91/100
Shows the user's getting started steps for HYPD.AI Competitor Ads: looking up a competitor's Facebook and Instagram ads, then who advertises on a Google search. Nothing needs connecting. Use it when init says so, or when the user is new or asks how to get started; a concrete question about a competitor goes straight to the adlib_* tools. Clients that render MCP Apps show the steps with a button each: a click sends that step's prompt as the user's next message, or opens the HYPD app. There, say only that the steps are shown above: do not repeat them and do not run a step before the user clicks it. Elsewhere, list the steps with their prompts and links.
The description explains the capability, when to use it, and what to expect.
Inputs100/100
This tool declares no inputs, so argument descriptions are not needed.
No input fields.
Annotations100/100
All four behavior hints are declared.
{
"title": "Getting started with HYPD.AI Competitor Ads",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
Output schema74/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"done_count",
"step_count"
],
"properties": {
"done_count": {
"type": "number",
"description": "Steps the user has completed."
},
"step_count": {
"type": "number",
"description": "Steps in total."
}
},
"description": "Counts only. The steps, with their prompts and links, go to the widget; the text content lists them for clients that show no widget.",
"additionalProperties": false
}
Original tool metadata
{
"name": "hypd_show_getting_started",
"title": "Getting started with HYPD.AI Competitor Ads",
"description": "Shows the user's getting started steps for HYPD.AI Competitor Ads: looking up a competitor's Facebook and Instagram ads, then who advertises on a Google search. Nothing needs connecting. Use it when init says so, or when the user is new or asks how to get started; a concrete question about a competitor goes straight to the adlib_* tools. Clients that render MCP Apps show the steps with a button each: a click sends that step's prompt as the user's next message, or opens the HYPD app. There, say only that the steps are shown above: do not repeat them and do not run a step before the user clicks it. Elsewhere, list the steps with their prompts and links.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"done_count",
"step_count"
],
"properties": {
"done_count": {
"type": "number",
"description": "Steps the user has completed."
},
"step_count": {
"type": "number",
"description": "Steps in total."
}
},
"description": "Counts only. The steps, with their prompts and links, go to the widget; the text content lists them for clients that show no widget.",
"additionalProperties": false
},
"annotations": {
"title": "Getting started with HYPD.AI Competitor Ads",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
Searches HYPD's help center for articles that answer a question about HYPD itself: connecting or reconnecting ad accounts, plans, billing and credits, privacy and data access, what HYPD can do, and setting HYPD up in Claude, ChatGPT or other AI clients. Returns the matching articles' text and links; answer from them and cite them. Not for advertising advice or the user's account data; use the platform tools for those.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
question
The user's question about HYPD, in their words, e.g. 'How do I connect my Google Ads account?'
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Search the HYPD help center",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
Output schema74/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status",
"articles",
"help_center_url",
"note"
],
"properties": {
"note": {
"type": "string",
"description": "How these results relate to the question."
},
"status": {
"enum": [
"ok",
"no_results"
],
"type": "string",
"description": "no_results when no article matched."
},
"articles": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url",
"description",
"content",
"updated_at"
],
"properties": {
"url": {
"type": "string",
"description": "The article's public link."
},
"title": {
"type": "string",
"description": "The article's title."
},
"content": {
"type": "string",
"description": "The article text to answer from."
},
"updated_at": {
"type": "string",
"description": "When the article last changed."
},
"description": {
"type": "string",
"description": "A one-line summary."
}
},
"additionalProperties": false
},
"description": "The matching articles."
},
"help_center_url": {
"type": "string",
"description": "The help center, for questions no article answers."
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "hypd_search_help",
"title": "Search the HYPD help center",
"description": "Searches HYPD's help center for articles that answer a question about HYPD itself: connecting or reconnecting ad accounts, plans, billing and credits, privacy and data access, what HYPD can do, and setting HYPD up in Claude, ChatGPT or other AI clients. Returns the matching articles' text and links; answer from them and cite them. Not for advertising advice or the user's account data; use the platform tools for those.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "The user's question about HYPD, in their words, e.g. 'How do I connect my Google Ads account?'"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status",
"articles",
"help_center_url",
"note"
],
"properties": {
"note": {
"type": "string",
"description": "How these results relate to the question."
},
"status": {
"enum": [
"ok",
"no_results"
],
"type": "string",
"description": "no_results when no article matched."
},
"articles": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url",
"description",
"content",
"updated_at"
],
"properties": {
"url": {
"type": "string",
"description": "The article's public link."
},
"title": {
"type": "string",
"description": "The article's title."
},
"content": {
"type": "string",
"description": "The article text to answer from."
},
"updated_at": {
"type": "string",
"description": "When the article last changed."
},
"description": {
"type": "string",
"description": "A one-line summary."
}
},
"additionalProperties": false
},
"description": "The matching articles."
},
"help_center_url": {
"type": "string",
"description": "The help center, for questions no article answers."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search the HYPD help center",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
Loading score analytics…
Put your MCP to the test
A few tasks worth trying with this server, chosen from its reviewed tools. These have not been run.
01Search Meta ads by keywordFinds Facebook and Instagram ads in Meta's public Ad Library that mention a keyword or phrase, across every advertiser: the way to see how a market advertise…
02Search the HYPD help centerSearches HYPD's help center for articles that answer a question about HYPD itself: connecting or reconnecting ad accounts, plans, billing and credits, privac…
03Find a brand on MetaTurns a brand or company name into the Facebook Page behind its Meta ads: each row's page_id is what adlib_meta_advertiser_ads takes, with the page_name, cat…
04See who advertises on a Google searchThe sponsored results Google shows for one search query right now, each with the advertiser's domain, headline, text and position: who bids on a keyword and…
05Screenshot a landing pageOpens a landing page in a real browser and returns a screenshot inline, so you can see where a competitor's ad sends people: the offer, the headline above th…
Want to run these tasks against your MCP server with us?
HYPD AI for Ad Library setup, tools, quality score, publishing readiness, and alternatives.
How do I add HYPD AI for Ad Library to Claude, ChatGPT, or Cursor?
Add HYPD AI for Ad Library to Claude, ChatGPT, or Cursor by connecting its remote MCP URL in each client's MCP settings. In Claude, add a custom connector. In ChatGPT, add an MCP app. In Cursor, add an MCP server under Settings. The MCP URL is https://adlibrary.hypd.ai/mcp.
Is HYPD AI for Ad Library MCP ready for ChatGPT and Claude?
As of November 16, 2026, HYPD AI for Ad Library scores 100/100 on Manufact's MCP publishing checklist. The scan meets ChatGPT publishing checks and meets Claude publishing checks. Passing these checks does not guarantee marketplace approval.
How clear is HYPD AI for Ad Library's MCP tool documentation?
As of November 16, 2026, HYPD AI for Ad Library scores 93/100 in Manufact's review of tool titles, descriptions, input and output schemas, and behavior annotations. The review covers 12 of 12 discovered tools. The quality score measures documentation clarity; runtime behavior and marketplace readiness require separate checks.
What are the best alternatives to HYPD AI for Ad Library?
As of November 17, 2026, alternatives to HYPD AI for Ad Library in marketing-seo on the Manufact MCP leaderboard include Notra, BulkPublish, Fuxux, HYPD AI for App Store Optimization, and HYPD AI for Google Merchant Center.
Not your MCP?
Review any public or OAuth MCP server for protocol compatibility, tool documentation, and ChatGPT and Claude publishing readiness. No account required.