flin-meta-ads-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| META_MAX_RETRIES | No | Retry count for transient failures, default 3 | 3 |
| META_ACCESS_TOKEN | Yes | Meta access token with read permissions | |
| RUN_LIVE_META_TESTS | No | Set to 1 to enable live integration tests | |
| META_TIMEOUT_SECONDS | No | Request timeout, default 30 | 30 |
| META_GRAPH_API_VERSION | No | Graph API version, default v21.0 | v21.0 |
| META_DEFAULT_AD_ACCOUNT_ID | No | Optional 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 18 tools
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).
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.
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.
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.