Linkedin Ads Mcp

What is Linkedin Ads Mcp?

Linkedin Ads Mcp is an MCP (Model Context Protocol) server that enables Claude AI to access and analyze your LinkedIn Ads data. It is built for marketers, founders, and growth teams who want to leverage AI for campaign optimization, performance reporting, and data-driven advertising decisions.

How to use Linkedin Ads Mcp?

You can install it either by copying a pre-made prompt into Claude Code (no coding required) or by following a guided setup in Claude Desktop. For manual installation, clone the repository, run npm install and npm run build, create a .env file with your LinkedIn Client ID and Client Secret, run npm run auth to authenticate, and configure the Claude Desktop config file. Once set up, ask natural‑language questions like “Show me campaign performance for the last 30 days” or “Which job functions are responding best to my ads?”

Key features of Linkedin Ads Mcp

• 14 specialized tools covering accounts, campaigns, creatives, audiences, conversions, and analytics
• Comprehensive metrics: Spend, Impressions, Clicks, CTR, Reach, Frequency, Engagements, CPM, CPC, Conversions, Conversion Rate, Cost per Conversion, and Audience Penetration
• Single OAuth authentication with automatic token refresh (tokens valid 60 days)
• Built-in exponential backoff for API rate limits
• Human-readable names for demographics (seniorities, job functions, industries, etc.)

Use cases of Linkedin Ads Mcp

• Query campaign performance using natural language
• Analyze audience demographics to understand who is engaging with ads
• Track conversions and leads across LinkedIn campaigns
• Compare performance between time periods, campaigns, or campaign groups
• Get AI-powered insights on your advertising data

FAQ from Linkedin Ads Mcp

What prerequisites are needed before installing?

You need Node.js (version 18 or higher), a LinkedIn Company Page, and a LinkedIn Developer App with Advertising API access.

How do I obtain LinkedIn API credentials?

Go to the LinkedIn Developer Portal, create a new app, request the Advertising API product (approval takes 1–5 days), add the redirect URL http://localhost:3000/callback under the Auth tab, and copy the Client ID and Client Secret.

How does authentication work?

Run npm run auth. It opens your browser to LinkedIn’s OAuth page, you authorize the app, and tokens are stored locally in ~/.linkedin-ads-mcp/tokens.json. Tokens automatically refresh before expiration.

What tools are available in Linkedin Ads Mcp?

Tools include list_ad_accounts, get_account_details, get_campaign_performance, get_creative_performance, get_campaign_groups, get_audience_demographics, get_audience_reach, list_saved_audiences, get_conversion_performance, and list_conversions, among others.

Does the server handle API rate limits?

Yes, it includes built-in exponential backoff to handle LinkedIn API rate limits gracefully.