LinkedIn Ads Library MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GEMINI_API_KEY | No | Google Gemini API key for video analysis. Optional; only needed for video ads. | |
| SCRAPECREATORS_API_KEY | Yes | API key for ads data provider. Required for self-hosted setup. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_linkedin_adsA | Search LinkedIn's Ad Library for the ads a company is running. Search by company name, by keyword across ad copy, or by LinkedIn company ID (most precise). Supports country and date-range filters. Returns headline, description, CTA, destination URL, targeting, impressions and media URLs. For complete analysis of visual elements, colors, design, or creative content, you MUST also use analyze_ad_image or analyze_ad_video on the media returned by each ad. |
| get_linkedin_ad_detailsA | Get detailed information about a specific LinkedIn ad including full targeting (language, location, audience), per-country impression breakdown, creative and destination URL. Use this with an ad id from search_linkedin_ads, or a linkedin.com/ad-library/detail/ URL. Essential for understanding who an advertiser is targeting and extracting media URLs for visual analysis. |
| analyze_ad_imageA | REQUIRED for analyzing images from LinkedIn ads. Download and analyze ad images (single image creatives, carousel cards and document/thumbnail covers) to extract visual elements, text content, colors, people, brand elements, and composition details. This tool should be used for EVERY image URL returned by search_linkedin_ads when doing comprehensive analysis. Uses intelligent caching so multiple image analysis calls are efficient and cost-free. |
| get_cache_statsA | REQUIRED for checking media cache status and storage usage. Use this tool when users ask about cache statistics, storage space used by cached media (images and videos), or how many files have been analyzed and cached. Essential for cache management and monitoring. |
| search_cached_mediaA | REQUIRED for finding previously analyzed ad media (images and videos) in cache. Use this tool when users want to search for cached media by brand name, find media with people, search by colors, or filter by media type. Essential for retrieving past analysis results without re-downloading media. |
| cleanup_media_cacheA | REQUIRED for cleaning up old cached media files (images and videos) and freeing disk space. Use this tool when users want to remove old cached media, clean up storage space, or when cache becomes too large. Essential for cache maintenance and storage management. |
| analyze_ad_videoA | REQUIRED for analyzing video ads from LinkedIn. Downloads and analyzes ad videos using Gemini's video understanding to extract the hook, scene-by-scene storytelling, on-screen text, voiceover, sound-off readability and B2B offer positioning. Pass ad_id alongside media_url so results cache per ad rather than per (expiring) CDN URL. Uses intelligent caching for efficiency. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool targets a distinct resource and action: live ad search, ad details, image analysis, video analysis, and cache management operations. There is no meaningful overlap between searching LinkedIn ads and searching cached media, and the analysis tools are cleanly separated by media type.
All tool names follow a consistent verb_noun snake_case pattern (e.g., search_linkedin_ads, analyze_ad_image, cleanup_media_cache). Verbs are descriptive and specific, with no mixing of conventions or vague names.
With 7 tools, the server is well-scoped for its purpose: searching and analyzing LinkedIn ads plus managing the media cache. Each tool serves a distinct function without redundancy or bloat.
The tool surface covers the full workflow: searching ads, retrieving detailed targeting/creative info, analyzing images and videos, and managing the cache that stores analyzed media. No obvious gaps or dead ends exist; cache stats and cleanup ensure lifecycle coverage.