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_itemsA | 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_criteriaA | 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_postsB | 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_reachB | 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_cardsB | 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_cardB | 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_libraryB | 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_criterionA | 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_previewsB | 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 cleanly separated by resource and action, and list/get pairs for the same resource are obvious rather than ambiguous. Search tools for interests vs locations and stats tools for account vs campaign level are also clearly distinct.
Every tool follows the same x_ads_verb_noun snake_case convention. The consistent list/get/search prefixes make the surface predictable.
At 25 tools, the surface is heavy for the apparent scope, though each tool maps to a distinct resource or metric. Many list/get pairs add breadth but also make the set borderline large.
The surface is essentially read-only: it lists and gets many resources but has no create, update, delete, or add operations for campaigns, line items, targeting criteria, cards, or media. A referenced add_targeting_criterion tool is missing, so agents cannot complete core ads-management workflows.