Skip to main content
Glama
flin-linkedin-ads-mcp

flin-linkedin-ads-mcp

by flin-agency

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LINKEDIN_API_VERSIONNoLinkedIn API version202603
LINKEDIN_MAX_RETRIESNoMaximum number of retries for API requests3
LINKEDIN_ACCESS_TOKENYesLinkedIn Access Token for authentication
LINKEDIN_TIMEOUT_SECONDSNoTimeout in seconds for API requests30
LINKEDIN_RESTLI_PROTOCOL_VERSIONNoLinkedIn RESTli protocol version2.0.0

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
connection_statusA

Report running server version, local configuration and authentication status. No network, browser, refresh or writes. Token presence means unknown, not authenticated. live_access is not_checked; use list_ad_accounts for an explicit live check.

linkedin_loginA

Connect or reconnect LinkedIn Ads, including after EXPIRED_ACCESS_TOKEN/401. Returns a login URL to open in a browser on the MCP server's computer. Saves credentials locally after consent. Requires configured LinkedIn app client ID and secret. Never ask for tokens, passwords or secrets in chat.

linkedin_login_statusA

Check local LinkedIn login progress and token expiry without exposing credentials. After login, use list_ad_accounts to verify API access.

list_ad_accountsC

List LinkedIn ad accounts accessible by the token

get_ad_accountB

Fetch one LinkedIn ad account by id

list_campaign_groupsC

List campaign groups for an ad account

get_campaign_groupB

Fetch one campaign group by id

list_campaignsC

List campaigns for an ad account

get_campaignC

Fetch one campaign by id

list_creativesC

List creatives for an ad account. Optional fields imageUrl and metadata use one extra GET per creative on API 202610+. Image URLs are external and may expire; restricted dashboards need approved embedded/local assets.

get_creativeB

Fetch one creative by id. Request fields imageUrl or metadata for the visual asset URL via CreativeMetadata on API 202610+, without needing Posts access. Image URLs are external and may expire.

get_creative_mediaA

Download an authorized creative's image or video thumbnail (kind=preview), or full MP4 (kind=video, requires Posts and Videos API access). output=inline returns a native MCP image; file saves locally; both does both for previews and saves a file for videos. Defaults: preview, both. Limits: images 5 MiB, videos 100 MiB. Files are on the MCP server's computer, not hosted URLs; use the dashboard's supported asset import. Rendering depends on the client. Downloads write only local files, never Ads data.

get_share_contentA

Resolve LinkedIn share/ugcPost content via the Posts and Images APIs. Requires their additional permissions. For ad images prefer get_creative with imageUrl on API 202610+. External image URLs alone cannot bypass dashboard restrictions.

get_insightsC

Fetch LinkedIn ads analytics

list_account_intelligenceC

List company-level account intelligence rows (private LinkedIn API access required)

search_ad_libraryA

Search public LinkedIn ads, including other advertisers, by keyword, advertiser, payer, country, dates, targeting categories and impression range. No ad account required. Requires the LinkedIn Ad Library product on the token's app, with no extra OAuth scope. Returns preview URLs and available transparency details; no ad copy/media download, clicks or spend. Targeting/impression details depend on availability (particularly EU ads). Without dates LinkedIn searches only today-2 to today-1. date_to is exclusive. Multiple keywords use AND.

search_brand_partnershipsA

Search organic LinkedIn posts declared by creators as brand partnerships. Returns post URLs. Requires the LinkedIn Ad Library product, no extra OAuth scope or ad account. Multiple keywords use AND. Without date_range searches available posts up to one year old.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.1/5.0

Scored across 17 tools

Disambiguation4/5

Most tools map to clearly distinct resources and actions, and the descriptions explicitly separate similar areas such as login status vs. connection status and creative metadata vs. creative media. Minor overlap between connection_status/linkedin_login_status and get_creative/get_creative_media/get_share_content keeps it from being fully unambiguous.

Naming Consistency4/5

The core tool set consistently uses snake_case verb_noun patterns such as list_campaigns, get_ad_account, and search_ad_library. The main deviations are the auth/status tools (connection_status, linkedin_login, linkedin_login_status), which are readable but do not follow the same verb-first convention.

Tool Count4/5

Seventeen tools is slightly above the ideal band but reasonable for a LinkedIn Ads surface spanning auth, accounts, campaigns, creatives, insights, and ad-library searches. Each tool appears to serve a distinct function rather than duplicating another.

Completeness3/5

The server covers read/analytics/media/ad-library workflows broadly, including authentication and live status checks. However, it lacks create, update, delete, pause/resume, and budget-management operations for campaigns, creatives, and accounts, leaving the ads lifecycle notably incomplete.

Maintenance

ActivityNo data
ResponsivenessOutdated data