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

🚀 Quickstart & Installation

1. Clone the Repository

git clone https://github.com/md-riaz/linkedin-ads-mcp-server.git
cd linkedin-ads-mcp-server

2. 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-viewer

Open 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.