glitch-grow-linkedin-ad-mcp 0.1.1

Glitch Grow LinkedIn Ad MCP — MCP server for the LinkedIn Marketing API. Read + write campaigns, analytics, creatives. Optionally use the hosted Glitch Grow app for instant API access (no Marketing API approval needed).

Glitch Grow LinkedIn Ad MCP

Model Context Protocol (MCP) server for the LinkedIn Marketing API. Read campaigns, pull analytics, create campaign groups + campaigns, flip statuses — all from any MCP client (Claude Desktop, Cursor, Continue, your own agent).

There's no official LinkedIn MCP. This fills that gap with a thin, correctness-first wrapper that handles LinkedIn's quirky restli encoding rules so you don't have to.

---

Two ways to use it

1. Bring your own LinkedIn Marketing API approval (DIY)

Standard path — apply for LinkedIn's Advertising API product on your own developer app, complete OAuth, paste tokens into .env. Free, full control, works for one LinkedIn user / N ad accounts shared with that user.

2. Use the Glitch Grow hosted app (instant access — no approval needed) ⚡

We already hold elevated access on the Glitch Grow LinkedIn Marketing Developer Platform app. If you don't want to wait for LinkedIn to approve your own app (which can take days and isn't always granted), you can connect our app to your LinkedIn account in one click and this MCP will read/write your ad accounts via our app's tokens.

Concretely: you authorize the Glitch Grow app once on your LinkedIn, we hand you a refresh token scoped to your accounts, you paste it into .env, and you're done. No Marketing API application, no waiting.

If that interests you, get in touch: https://grow.glitchexecutor.com · [e-mail].

---

Why this exists

If you've tried calling LinkedIn's /rest/adAnalytics endpoint by hand you've probably hit walls like:

• Commas in fields= get URL-encoded by default HTTP clients → 400 not present in schema
• URN colons inside accounts=List(urn:li:sponsoredAccount:NNN) need to be %3A but date-tuple colons must stay literal
• Partial updates need X-RestLi-Method: PARTIAL_UPDATE or they get ignored
• runSchedule.start must be ≥ now-ish, totalBudget.amount must be ≥ $100
• New campaigns need politicalIntent (LinkedIn's equivalent of Google's EU political-ad declaration)

This server has all those rules already encoded.

Install

pip install glitch-grow-linkedin-ad-mcp
# or, in a project:
uv add glitch-grow-linkedin-ad-mcp

OAuth setup (DIY path)

1. Create a LinkedIn app at https://www.linkedin.com/developers/apps.

2. On the Products tab, request Advertising API (auto-approved if you have an active Campaign Manager account).

3. Run any OAuth flow that grants the scopes r_ads, rw_ads, r_ads_reporting — for example:

   https://www.linkedin.com/oauth/v2/authorization?response_type=code
     &client_id=$YOUR_CLIENT_ID
     &redirect_uri=$YOUR_REDIRECT_URI
     &scope=r_ads%20rw_ads%20r_ads_reporting
   

4. Exchange the code for tokens. Save the access + refresh tokens.

5. Copy .env.example to .env and paste them.

OAuth setup (Glitch Grow hosted app)

Skip steps 1–3 above. Reach out to us, complete the one-click connect flow on your LinkedIn account, paste the tokens we hand you into the same .env. Done.

Run

# stdio (for Claude Desktop, Cursor, Continue, etc.)
glitch-grow-linkedin-ad-mcp

# SSE on :8000
glitch-grow-linkedin-ad-mcp --transport sse --port 8000

Claude Desktop config

{
  "mcpServers": {
    "glitch-grow-linkedin-ad": {
      "command": "glitch-grow-linkedin-ad-mcp",
      "env": {
        "LINKEDIN_CLIENT_ID": "...",
        "LINKEDIN_CLIENT_SECRET": "...",
        "LINKEDIN_REFRESH_TOKEN": "..."
      }
    }
  }
}

Tools

Read

Tool	What it does
list_ad_accounts()	Every ad account the OAuth user can access
list_account_users(account_id)	User → role assignments
list_campaign_groups(account_id)	Campaign groups + total budgets
list_campaigns(account_id)	All campaigns + structure (no metrics)
list_creatives(account_id)	Creative roster
get_account_analytics(account_id, days=14)	Account-level totals
get_campaign_analytics(account_id, days=14)	Per-campaign metrics, sorted by spend

Write

Tool	What it does
create_campaign_group(account_id, name, total_budget=100, days=30, status="DRAFT")	Create a group
create_campaign(account_id, name, campaign_group_urn, daily_budget=10, …)	Create a campaign (defaults to safe DRAFT TEXT_AD)
update_campaign_status(account_id, campaign_id, status)	DRAFT / ACTIVE / PAUSED / ARCHIVED
update_campaign_group_status(account_id, group_id, status)	Same set + CANCELED

All write tools default to DRAFT so nothing goes live by accident. Promote a group → ACTIVE first, then promote campaigns → PAUSED → ACTIVE in two explicit steps.

Multi-tenant pattern

LinkedIn doesn't have an MCC, but Campaign Manager has equivalent "Manage Access" sharing. To run this MCP across multiple advertisers:

1. Each client adds the OAuth user (Glitch Grow's, or yours if DIY) as CAMPAIGN_MANAGER on their ad account in Campaign Manager → Account Settings → Manage Access.
2. After they accept, list_ad_accounts() returns their account.
3. Pass that account_id to any subsequent tool call. One OAuth dance, N advertiser accounts — same model as the Google Ads MCC pattern.

Status

Read API + write API for groups + campaigns are battle-tested in production. Sponsored creative creation (image/video upload via initializeUpload → bind to /rest/creatives → attach to a campaign) uses the same upload pattern Glitch Grow already runs against /rest/documents and /rest/posts for organic publishing — porting that to the sponsored-ad surface is on the roadmap. PRs welcome in the meantime.

License

MIT — see LICENSE.

About

Built and maintained by Glitch Grow (Glitch Executor Labs). The Glitch Grow LinkedIn Ad MCP is hardened against real LinkedIn Marketing API behavior in production. If you hit a restli encoding edge case we missed, please open an issue with the offending URL — we'll codify the fix.