KosmoKrator

marketing

X Ads MCP Integration for OpenAI Agents SDK

Connect X Ads to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

190 functions 99 read 91 write oauth1a user context auth
Submit X Ads feedback View package source

Connect X Ads to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

X Ads MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-x_ads": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=x_ads",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=x_ads --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only X Ads instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

X Ads Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the X Ads integration catalog.

MCP toolSource functionTypeDescription
integration__x_ads__x_ads_get_stats_accounts_account_id_active_entities x_ads.x_ads_get_stats_accounts_account_id_active_entities Read X Ads API operation: Analytics / Active Entities stats/accounts/:account_id/active_entities.
integration__x_ads__x_ads_get_stats_jobs_accounts_account_id x_ads.x_ads_get_stats_jobs_accounts_account_id Read X Ads API operation: Analytics / Asynchronous Analytics stats/jobs/accounts/:account_id.
integration__x_ads__x_ads_post_stats_jobs_accounts_account_id x_ads.x_ads_post_stats_jobs_accounts_account_id Write X Ads API operation: Analytics / Asynchronous Analytics stats/jobs/accounts/:account_id.
integration__x_ads__x_ads_delete_stats_jobs_accounts_account_id_job_id x_ads.x_ads_delete_stats_jobs_accounts_account_id_job_id Write X Ads API operation: Analytics / Asynchronous Analytics stats/jobs/accounts/:account_id/:job_id.
integration__x_ads__x_ads_get_accounts_account_id_auction_insights x_ads.x_ads_get_accounts_account_id_auction_insights Read X Ads API operation: Analytics / Auction Insights accounts/:account_id/auction_insights.
integration__x_ads__x_ads_get_stats_accounts_account_id_reach_campaigns x_ads.x_ads_get_stats_accounts_account_id_reach_campaigns Read X Ads API operation: Analytics / Reach and Average Frequency stats/accounts/:account_id/reach/campaigns.
integration__x_ads__x_ads_get_stats_accounts_account_id_reach_funding_instruments x_ads.x_ads_get_stats_accounts_account_id_reach_funding_instruments Read X Ads API operation: Analytics / Reach and Average Frequency stats/accounts/:account_id/reach/funding_instruments.
integration__x_ads__x_ads_get_stats_accounts_account_id x_ads.x_ads_get_stats_accounts_account_id Read X Ads API operation: Analytics / Synchronous Analytics stats/accounts/:account_id.
integration__x_ads__x_ads_get_insights_accounts_account_id x_ads.x_ads_get_insights_accounts_account_id Read X Ads API operation: Audience / Insights insights/accounts/:account_id.
integration__x_ads__x_ads_get_insights_accounts_account_id_available_audiences x_ads.x_ads_get_insights_accounts_account_id_available_audiences Read X Ads API operation: Audience / Insights insights/accounts/:account_id/available_audiences.
integration__x_ads__x_ads_get_insights_keywords_search x_ads.x_ads_get_insights_keywords_search Read X Ads API operation: Audience / Keyword Insights insights/keywords/search.
integration__x_ads__x_ads_get_accounts_account_id_tailored_audiences_tailored_audience_id_permissions x_ads.x_ads_get_accounts_account_id_tailored_audiences_tailored_audience_id_permissions Read X Ads API operation: Audience / Tailored Audience Permissions accounts/:account_id/tailored_audiences/:tailored_audience_id/permissions.
integration__x_ads__x_ads_post_accounts_account_id_tailored_audiences_tailored_audience_id_permissions x_ads.x_ads_post_accounts_account_id_tailored_audiences_tailored_audience_id_permissions Write X Ads API operation: Audience / Tailored Audience Permissions accounts/:account_id/tailored_audiences/:tailored_audience_id/permissions.
integration__x_ads__x_ads_delete_accounts_account_id_tailored_audiences_tailored_audience_id_permissions_tailored_audience_permission_id x_ads.x_ads_delete_accounts_account_id_tailored_audiences_tailored_audience_id_permissions_tailored_audience_permission_id Write X Ads API operation: Audience / Tailored Audience Permissions accounts/:account_id/tailored_audiences/:tailored_audience_id/permissions/:tailored_audience_permission_id.
integration__x_ads__x_ads_get_accounts_account_id_tailored_audiences x_ads.x_ads_get_accounts_account_id_tailored_audiences Read X Ads API operation: Audience / Tailored Audiences accounts/:account_id/tailored_audiences.
integration__x_ads__x_ads_get_accounts_account_id_tailored_audiences_tailored_audience_id x_ads.x_ads_get_accounts_account_id_tailored_audiences_tailored_audience_id Read X Ads API operation: Audience / Tailored Audiences accounts/:account_id/tailored_audiences/:tailored_audience_id.
integration__x_ads__x_ads_post_accounts_account_id_tailored_audiences x_ads.x_ads_post_accounts_account_id_tailored_audiences Write X Ads API operation: Audience / Tailored Audiences accounts/:account_id/tailored_audiences.
integration__x_ads__x_ads_post_batch_accounts_account_id_tailored_audiences x_ads.x_ads_post_batch_accounts_account_id_tailored_audiences Write X Ads API operation: Audience / Tailored Audiences batch/accounts/:account_id/tailored_audiences.
integration__x_ads__x_ads_delete_accounts_account_id_tailored_audiences_tailored_audience_id x_ads.x_ads_delete_accounts_account_id_tailored_audiences_tailored_audience_id Write X Ads API operation: Audience / Tailored Audiences accounts/:account_id/tailored_audiences/:tailored_audience_id.
integration__x_ads__x_ads_post_accounts_account_id_tailored_audiences_tailored_audience_id_users x_ads.x_ads_post_accounts_account_id_tailored_audiences_tailored_audience_id_users Write X Ads API operation: Audience / Tailored Audiences Users accounts/:account_id/tailored_audiences/:tailored_audience_id/users.
integration__x_ads__x_ads_get_accounts x_ads.x_ads_get_accounts Read X Ads API operation: Campaign Management / Accounts accounts.
integration__x_ads__x_ads_get_accounts_account_id x_ads.x_ads_get_accounts_account_id Read X Ads API operation: Campaign Management / Accounts accounts/:account_id.
integration__x_ads__x_ads_post_accounts x_ads.x_ads_post_accounts Write X Ads API operation: Campaign Management / Accounts accounts.
integration__x_ads__x_ads_put_accounts_account_id x_ads.x_ads_put_accounts_account_id Write X Ads API operation: Campaign Management / Accounts accounts/:account_id.
integration__x_ads__x_ads_delete_accounts_account_id x_ads.x_ads_delete_accounts_account_id Write X Ads API operation: Campaign Management / Accounts accounts/:account_id.
integration__x_ads__x_ads_get_accounts_account_id_authenticated_user_access x_ads.x_ads_get_accounts_account_id_authenticated_user_access Read X Ads API operation: Campaign Management / Authenticated User Access accounts/:account_id/authenticated_user_access.
integration__x_ads__x_ads_get_bidding_rules x_ads.x_ads_get_bidding_rules Read X Ads API operation: Campaign Management / Bidding Rules bidding_rules.
integration__x_ads__x_ads_get_accounts_account_id_campaigns x_ads.x_ads_get_accounts_account_id_campaigns Read X Ads API operation: Campaign Management / Campaigns accounts/:account_id/campaigns.
integration__x_ads__x_ads_get_accounts_account_id_campaigns_campaign_id x_ads.x_ads_get_accounts_account_id_campaigns_campaign_id Read X Ads API operation: Campaign Management / Campaigns accounts/:account_id/campaigns/:campaign_id.
integration__x_ads__x_ads_post_accounts_account_id_campaigns x_ads.x_ads_post_accounts_account_id_campaigns Write X Ads API operation: Campaign Management / Campaigns accounts/:account_id/campaigns.

Showing 30 of 190 functions. See the X Ads MCP reference for the full list.

Related X Ads Pages

X Ads CLIUse direct JSON commands instead of MCP discovery. X Ads MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.