flin-linkedin-ads-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LINKEDIN_API_VERSION | No | LinkedIn API version | 202603 |
| LINKEDIN_MAX_RETRIES | No | Maximum number of retries for API requests | 3 |
| LINKEDIN_ACCESS_TOKEN | Yes | LinkedIn Access Token for authentication | |
| LINKEDIN_TIMEOUT_SECONDS | No | Timeout in seconds for API requests | 30 |
| LINKEDIN_RESTLI_PROTOCOL_VERSION | No | LinkedIn RESTli protocol version | 2.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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
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.
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.
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.
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.