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

flin-meta-ads-mcp

by flin-agency

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
META_MAX_RETRIESNoRetry count for transient failures, default 33
META_ACCESS_TOKENYesMeta access token with read permissions
RUN_LIVE_META_TESTSNoSet to 1 to enable live integration tests
META_TIMEOUT_SECONDSNoRequest timeout, default 3030
META_GRAPH_API_VERSIONNoGraph API version, default v21.0v21.0
META_DEFAULT_AD_ACCOUNT_IDNoOptional fallback ad account (e.g. act_123...)

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
list_ad_accountsC

List ad accounts accessible by the token

get_ad_accountB

Fetch a single ad account by id

list_campaignsC

List campaigns for an ad account

get_campaignB

Fetch a single campaign by id

list_adsetsC

List ad sets for an ad account

get_adsetB

Fetch a single ad set by id

list_adsC

List ads for an ad account

get_adB

Fetch a single ad by id

list_ad_imagesB

List ad images for an ad account

get_ad_imageC

Fetch a single ad image by id

download_ad_imageA

Download a Meta CDN image URL returned by list_ad_images, get_ad_image, or get_ad_creative. Returns the actual image file as an embedded binary resource and a direct image preview, without requiring the client to fetch the external URL. Supports JPEG, PNG, GIF, WebP up to 5 MiB. Use a fresh URL if expired.

list_ad_creativesC

List ad creatives for an ad account

get_ad_creativeA

Fetch a single ad creative by id

get_ad_previewB

Fetch or generate a rendered preview for an ad or ad creative

get_insightsA

Fetch insights for an account, campaign, ad set, or ad

connection_statusA

Show the running server version and local setup without network access. Set check_live=true for one read-only Meta account access check. Never returns secrets or account data; never starts login.

get_meta_auth_statusA

Check whether Meta login is needed or has completed. Never returns tokens or secrets.

start_meta_loginA

Start Meta browser login when the user wants to sign in. Returns a login URL. Requires META_APP_SECRET in server configuration; app_id is public and optional if META_APP_ID is configured. After browser approval call get_meta_auth_status.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.2/5.0

Scored across 18 tools

Disambiguation4/5

Each resource (account, campaign, adset, ad, image, creative) has a clear list_/get_ pair, and the auth/insight tools are distinct. Minor potential confusion between get_ad_preview and download_ad_image, but descriptions clarify the boundary (rendered preview vs. binary file download).

Naming Consistency5/5

Consistent snake_case verb_noun pattern throughout (list_campaigns, get_ad, download_ad_image, get_insights). The two status tools (connection_status, get_meta_auth_status) are slight noun-form deviations but remain readable and predictable.

Tool Count4/5

18 tools is slightly heavy but each maps to a distinct resource or lifecycle step in the Meta Ads domain. The list/get pairs across six resources justify the count without obvious redundancy.

Completeness3/5

The surface is entirely read-only: no create/update/pause/delete operations for campaigns, adsets, ads, or creatives, which are core to ad management. Insights and previews are covered, but an agent cannot perform write workflows, a notable gap for an ads server.

Maintenance

ActivityMaintained
ResponsivenessOutdated data