LinkedIn Ad Library MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@LinkedIn Ad Library MCP Server Search for ads from Stripe in the US"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
LinkedIn Ad Library MCP Server
An MCP server that connects AI assistants to LinkedIn's Ad Library API. Search any advertiser's sponsored content, job postings, and influencer partnerships — directly from Claude or any MCP-compatible client.
Use Cases
Competitor Ad Analysis — See what ads your competitors are running, where they're targeting, and how much reach they're getting. Compare messaging strategies across markets.
Creative Benchmarking — Discover which ad formats (video, image, document, carousel) competitors use most. Analyze copy patterns and CTAs across your industry.
Hiring Signal Tracking — Monitor sponsored job postings to spot competitors scaling teams, entering new markets, or launching new products based on the roles they're hiring for.
Influencer & Thought Leader Discovery — Find which brands are running thought leader ads (paid endorsements) and identify creator partnerships in your space.
Related MCP server: LinkedIn MCP Server
Tools
Tool | What it does |
| Search sponsored ads — returns advertiser, ad type, impressions, country distribution, targeting |
| Search sponsored job postings — returns title, organization, location, description |
| Search thought leader ads — returns post URLs |
Example Prompts
Once connected, try asking your AI assistant:
"Show me all LinkedIn ads mentioning Klarna in the last month"
"Compare the ad targeting strategy of Stripe vs Adyen in Europe"
"What job roles is Revolut sponsoring on LinkedIn right now?"
"Find thought leader ads in the BNPL space"
"Analyze the top 50 fintech ads by impression volume and summarize the messaging patterns"
"Which countries is PayPal targeting with their LinkedIn campaigns?"Prerequisites
A LinkedIn Developer App with the Ad Library product enabled
A LinkedIn OAuth access token (expires every 60 days)
Getting Your Access Token
Fastest way — use LinkedIn's built-in token generator:
Go to LinkedIn Token Generator
Select your app
Select any scope (e.g.,
openid)Click Request access token
Copy the token
Alternative — manual OAuth flow:
Add a redirect URI in your app's Auth tab
Visit:
https://www.linkedin.com/oauth/v2/authorization?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&scope=openid&state=random123Authorize → copy the
codeparameter from the redirectExchange it:
curl -X POST https://www.linkedin.com/oauth/v2/accessToken \ -d grant_type=authorization_code \ -d code=AUTH_CODE \ -d client_id=YOUR_CLIENT_ID \ -d client_secret=YOUR_SECRET \ -d redirect_uri=YOUR_REDIRECT_URI
Setup
git clone https://github.com/confortistefano/linkedin-ads-library-mcp.git
cd linkedin-ads-library-mcp
npm install
npm run buildConnect to Claude Code
Add to your MCP settings (.claude/settings.json or project settings):
{
"mcpServers": {
"linkedin-ads": {
"command": "node",
"args": ["/path/to/linkedin-ads-library-mcp/dist/index.js"],
"env": {
"LINKEDIN_ACCESS_TOKEN": "your-token-here"
}
}
}
}Connect to Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"linkedin-ads": {
"command": "node",
"args": ["/path/to/linkedin-ads-library-mcp/dist/index.js"],
"env": {
"LINKEDIN_ACCESS_TOKEN": "your-token-here"
}
}
}
}Docker
echo "LINKEDIN_ACCESS_TOKEN=your-token" > .env
docker compose up -dServer available at http://localhost:3001/mcp.
API Reference
This server wraps LinkedIn's Ad Library API (version 202503):
Endpoint | Method | Tool |
| FINDER |
|
| FINDER |
|
| FINDER |
|
Rate Limits
LinkedIn doesn't publish specific rate limits. What we know:
Limits are per-app, per-day, reset at midnight UTC
HTTP 429 = limit reached, wait until reset
Email alert at 75% usage
Check your limits: Developer Portal → your app → Analytics tab
Environment Variables
Variable | Default | Description |
| required | OAuth access token |
|
| Transport mode: |
|
| HTTP server port |
|
| HTTP server bind address |
|
| Max requests per minute (HTTP mode) |
Development
LINKEDIN_ACCESS_TOKEN=your-token npm run dev # Dev mode with hot reload
npm run build # Compile TypeScript
LINKEDIN_ACCESS_TOKEN=your-token npm start # ProductionDisclaimer
This is an unofficial, community-built tool. Not affiliated with or endorsed by LinkedIn. Users are responsible for complying with LinkedIn's API Terms of Use and must provide their own Developer App credentials.
License
MIT
Available Tools
3 toolssearch_adsA
Search LinkedIn sponsored ads by keyword, company, or topic. Use to analyze competitor ad copy, messaging strategy, creative formats, geo-targeting, and audience segmentation.
Returns: advertiser name and payer, ad type (video, image, document, status update), impression ranges, country distribution (%), targeting facets (language, location, job title, company, audience), and direct link to the ad.
Example: search_ads({ keyword: "klarna", count: 25 })
Inputs: keyword (required), count, start.
search_jobsA
Search LinkedIn sponsored job postings. Use to track competitor hiring patterns, team expansion signals, and market positioning through the roles they're investing in.
Returns: job title, organization, location, payer (who's paying for the sponsorship), and description preview.
Example: search_jobs({ keyword: "fintech product manager", count: 25 })
Inputs: keyword (required), count, start.
search_paid_endorsementsA
Search LinkedIn thought leader ads (paid endorsements). Use to identify influencer partnerships, executive branding strategies, and creator-driven campaigns by competitors.
Returns: direct URLs to the sponsored posts.
Example: search_paid_endorsements({ keyword: "scalapay" })
Inputs: keyword (required), count, start.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct category: sponsored ads, jobs, and paid endorsements. There is no overlap between the search functions, and the descriptions clearly differentiate their purposes.
All tool names follow a consistent 'search_' + noun pattern, making the set predictable and easy to navigate. The naming convention is uniform across all three tools.
Three tools is minimal but appropriate for the server's narrow scope—it covers the three main segments of LinkedIn's Ad Library. While slightly thin, each tool serves a clear and necessary function.
The set covers the primary ad types available in LinkedIn's Ad Library: regular ads, jobs, and thought leader ads. It provides comprehensive search results for each, though more granular detail endpoints (e.g., fetch by ID) are missing, but they are not essential for typical competitor analysis.
Maintenance
Related MCP Connectors
Real-time Meta, Google, LinkedIn and TikTok ad library access for AI assistants. No API keys.
LinkedIn jobs, companies and people for AI agents, plus messages and invites via your own account.
LinkedIn for AI agents: search people, read profiles, posts and connections via a connected account
LinkedIn actions for AI agents: search, messaging, posts and invites, as hosted MCP tools.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI assistants to interact with LinkedIn by scraping profiles, companies, job postings, and getting personalized job recommendations using authenticated browser automation.175,729 PyPI4,198Apache 2.0
- AlicenseAqualityCmaintenanceEnables searching and scraping of LinkedIn for structured data on people, companies, and job listings. It allows AI clients to retrieve detailed profiles, experience, and activity sections using browser automation.7217MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to connect to LinkedIn, accessing profiles and companies, searching for jobs and people, managing saved jobs, updating job-search profile settings, and inspecting analytics.1Apache 2.0
- AlicenseAqualityDmaintenanceEnables searching and scraping of LinkedIn profiles, companies, jobs, and posts using natural language through MCP-compatible AI clients.13MIT