X Ads by Get MCP Ads
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| X_ADS_SCOPES | No | Scopes actually granted to the token. Defaults to ads.read. | ads.read |
| X_ADS_ACCOUNT_IDS | Yes | Required comma-separated account IDs, restricted to accounts the token may access. | |
| X_ADS_ACCESS_TOKEN | Yes | Your user OAuth 2.0 access token. An app-only bearer token is not sufficient. | |
| X_ADS_ENABLE_WRITES | No | Defaults to false. Only the exact value true exposes writes. | false |
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": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| x_ads_list_ads_accountsA | List the ads accounts the authenticated user can access Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_list_campaignsA | List campaigns for an account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_get_campaignA | Get a single campaign by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_list_funding_instrumentsA | List funding instruments (payment sources) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_list_line_itemsC | List line items (ad groups) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_get_line_itemA | Get a single line item by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_list_promoted_postsA | List promoted posts (promoted tweets) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_list_targeting_criteriaB | List targeting criteria for an ads account's line items Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_list_account_postsA | List posts (tweets) usable for promotion by an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_list_web_event_tagsA | List the website conversion event tags (pixels) in an ads account; a tag's id is what a conversion line item takes as its primary_web_event_tag Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_list_line_item_placementsB | List valid placement combinations per line item product type Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_get_account_statsA | Get synchronous analytics (impressions, engagements, spend) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_get_active_entitiesA | List which ads entities had metrics change in a time window (use before requesting account stats) Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_get_campaign_reachA | Get reach and average-frequency metrics for campaigns Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_search_targeting_interestsA | Search targetable interest categories by name. Use this to find the targeting_value IDs required by add_targeting_criterion for INTEREST-type criteria. Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_search_targeting_locationsA | Search targetable locations by name. Use this to find the targeting_value IDs required by add_targeting_criterion for LOCATION-type criteria. Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_list_cardsA | List the cards in an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_get_cardA | Get a single card by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_list_media_libraryA | List the media library objects in an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_get_media_library_itemA | Get a single media library object by media key Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_get_promoted_postA | Get a single promoted post by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_get_targeting_criterionB | Get a single targeting criterion by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_list_post_previewsA | Get rendered HTML previews for published or scheduled posts Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_get_web_event_tagA | Get a single website conversion event tag by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. |
| x_ads_get_media_upload_statusA | Read processing status of an upload owned by the connected X user. Media uploads are user-owned until registered in the selected account's media library. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| X Ads guide |
TDQS
Scored across 25 tools
Tools are generally distinct by resource and action, with list/get/search clearly separated. Minor confusion is possible between account posts vs promoted posts and existing targeting criteria vs targeting searches, but descriptions provide enough context.
Every tool follows the x_ads_ prefix with a consistent verb_noun pattern: list_ for collections, get_ for single items, and search_ for lookups. No mixed naming conventions or vague verbs.
25 tools is at the heavy end of the range, though each maps to a distinct X Ads resource or action. The set is broad enough to feel justified, but it is larger than ideal and borders on overwhelming.
Read coverage is strong across accounts, campaigns, line items, media, cards, posts, and stats. However, there are no create/update/delete tools and multiple references to missing capabilities like add_targeting_criterion and media upload registration, leaving workflow dead ends.