LinkedIn Ads MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
LinkedIn Ads MCP Server π
An open-source, token-efficient Model Context Protocol (MCP) Server designed specifically for LinkedIn Campaign Manager & Ads Management.
It allows AI assistants (such as Antigravity, Claude Desktop, Cursor, etc.) to perform deep audits, analyze campaign performance, review targeting setups, inspect ad creatives, and analyze audience demographics without requiring a LinkedIn Developer App or official API approvals.
β¨ Key Features
π Zero Developer App Required: Uses your existing authenticated browser session via anti-detect Patchright.
β‘ Ultra Low Token Consumption: Returns structured, clean JSON responses directly to the LLM instead of bulky DOM trees or screenshots.
π Comprehensive Ads Intelligence: Full coverage for Campaign Manager Accounts, Campaign Groups, Campaigns, Creatives, Demographics, and Conversion Tracking.
π³ Docker-Ready: Completely containerized with persistent session storage.
π‘οΈ Safety-First Design: Focused on deep inspection, read-only analysis, and auditing to protect your advertising budgets.
Related MCP server: LinkedIn Ads MCP Server
π οΈ Available MCP Tools
Tool Name | Scope | Description |
| Accounts | Lists all accessible LinkedIn Ad Accounts, Account IDs, currency, and statuses. |
| Billing | Audits billing status, payment methods, credit balance, and holds. |
| Campaigns | Lists campaign groups, objectives, budgets, and schedules. |
| Campaigns | Lists all campaigns in an account (Objective, Status, Budget, Spend, Clicks). |
| Targeting | Deep inspection of targeting criteria (Job titles, Industries, Geography, Bidding). |
| Creatives | Inspects ad copy, headlines, CTAs, destination URLs, and creative formats. |
| Performance | Retrieves performance KPIs (Spend, Impressions, Clicks, CTR, CPC, Conversions). |
| Demographics | Analyzes audience reach across Job Function, Industry, Seniority, Company Size, etc. |
| Audiences | Lists retargeting segments, contact lists, and matched audiences. |
| Conversions | Checks LinkedIn Insight Tag health and active conversion tracking rules. |
| Leads | Audits configured Lead Gen Forms, fields collected, and submission rates. |
π Quickstart & Installation
1. Clone the Repository
git clone https://github.com/md-riaz/linkedin-ads-mcp-server.git
cd linkedin-ads-mcp-server2. Build the Docker Image
docker build -t linkedin-ads-mcp:latest .3. One-Time Authentication
If you haven't authenticated your LinkedIn session in Docker yet, run the one-time login command:
docker run -it --rm \
-v linkedin-mcp-data:/home/pwuser/.linkedin-mcp \
-p 127.0.0.1:6080:6080 \
stickerdaniel/linkedin-mcp-server:latest \
--login --login-viewerOpen http://127.0.0.1:6080 in your browser and sign in once. The session is permanently saved in the linkedin-mcp-data volume.
βοΈ MCP Client Configuration
For Antigravity / Claude Desktop (mcp_config.json):
Add the following block to your mcp_config.json:
{
"mcpServers": {
"linkedin-ads-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e", "FASTMCP_CHECK_FOR_UPDATES=off",
"-v", "linkedin-mcp-data:/home/pwuser/.linkedin-mcp",
"linkedin-ads-mcp:latest"
]
}
}
}π Project Structure
linkedin-ads-mcp-server/
βββ Dockerfile
βββ docker-compose.yml
βββ pyproject.toml
βββ README.md
βββ LICENSE
βββ src/
βββ __init__.py
βββ server.py # FastMCP entrypoint
βββ config.py # Environment & paths configuration
βββ browser.py # Patchright browser lifecycle manager
βββ tools/
βββ __init__.py
βββ accounts.py # Ad Accounts & Billing tools
βββ campaigns.py # Campaigns & Targeting tools
βββ analytics.py # Performance & Demographics tools
βββ creatives.py # Ad Creatives & Copy tools
βββ audiences.py # Matched Audiences & Insight Tag toolsπ License
MIT License. Free for personal and commercial use.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
Related MCP Connectors
LinkedIn ads, ABM and CRM data for AI agents: reports, audits, and campaign management.
Connect authorized ad accounts to AI assistants for audits, reporting, and approval-gated changes.
Real-time Meta, Google, LinkedIn and TikTok ad library access for AI assistants. No API keys.
Open-source ad agent for LinkedIn Ads and Google Ads. Drafts campaigns, audiences and reports.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides read access to campaign performance data from Google Ads, Meta Ads, and TikTok Ads via live API calls, enabling AI assistants to analyze and audit advertising campaigns.162MIT
- AlicenseNot gradedqualityCmaintenanceEnables management and analysis of LinkedIn ad campaigns, including listing accounts, campaigns, creatives, and retrieving analytics, through natural language queries.82 npmMIT
- FlicenseNot gradedqualityDmaintenanceProvides LinkedIn Ads data and management capabilities to AI assistants via MCP, with LinkedIn SSO authentication and a web-based setup/admin interface.-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to access, analyze, and manage LinkedIn advertising data, including campaigns, creatives, audiences, and conversions, with full create, update, and delete capabilities plus analytics via natural language.42MIT