> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/mcp/exoclick-mcp-tools.md). # Available tools Once connected, your AI assistant will have access to the following tools. You do not need to call these directly - simply ask your question in natural language and the AI will use the appropriate tool automatically. ## What a connection is allowed to do When you connect an AI client, you choose an access level for each capability:
LevelMeaning
ReadThe AI can view this data.
WriteThe AI can view this data and make changes.
No accessThe AI cannot use this capability at all.
These settings only narrow what the AI may do. A connection can never do more than your account already allows. Capabilities your account does not hold, and capabilities that are not yet available, are not shown. See [Connecting AI Client](/mcp/exoclick-mcp-connecting-ai-client.md) for where this is set. ## **Statistics** View performance data for your account, with flexible filtering and grouping. Available to advertisers and publishers, each scoped to their own data. **Access:** Read ### Advertiser statistics Query your advertiser statistics with flexible filtering and grouping options. This tool lets you analyse impressions, clicks, conversions, revenue, costs, and other performance metrics across any combination of dimensions. #### What can you ask * Campaign performance over a date range * Breakdowns by country, device, browser, operating system, zone, or any other available dimension * Top or bottom performers by any metric * Comparisons between time periods * Filtered views (e.g., statistics for a specific campaign or zone) #### Example prompts * *Give me the top campaigns by spending for the last 7 days.* * *What is my eCPA by country this month?* * *Compare my impressions this week versus last week, grouped by device type.* * *Which zones had the lowest CR yesterday?* Query your advertiser statistics with flexible filtering and grouping options. This tool lets you analyse impressions, clicks, conversions, costs, and other performance metrics across any combination of dimensions. ### Publisher statistics Query your publisher statistics with flexible filtering and grouping options. This tool lets you analyze impressions, clicks, eCPM, and other performance metrics across any combination of dimensions. #### What can you ask * Zone performance over a date range * Breakdowns by country, device, browser, operating system, zone, or any other available dimension * Top or bottom performers by any metric * Comparisons between time periods * Filtered views (e.g., statistics for a specific campaign or zone) #### Example prompts * *Give me the top zones by revenue for the last 7 days.* * *What is my eCPM by country this month?* * *Compare my impressions this week versus last week, grouped by device type.* * *Which zones within my multi-format had the best results yesterday?* ## Campaigns View your campaign configuration without leaving the conversation This is an **advertiser-only** tool. **Access:** Read or Write ### Viewing #### **What can you ask** * A list of your campaigns, filtered by status (running, paused) or searched by name * The full configuration of a single campaign (If you request a campaign that does not exist or belongs to another account, the tool returns a clear "not found" error.) * How many campaigns you have in a given state * The minimum bid for a format and category in a given country * Which targeting options your account can use A campaign list returns id, name, and status for each campaign. Asking about one campaign returns its full configuration, covering: | Area | What is include | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Identity | Name, id, campaign group, campaign type, creation date. | | Ad Format | Ad type and label, creative size. | | Pricing | Pricing model (CPM, CPC, and so on), price, optimisation algorithm, linked bidder. | | Budget and delivery | Total and daily budget limits, amount spent, impression limits, delivery mode, frequency capping. | | Schedule | Start and end dates, timezone, day parting. | | Targeting | Countries and regions, languages, browsers, operating systems, devices, carriers, ISPs, categories, interests, keywords, IP ranges, sites, zones, RTB inventory, and retargeting lists. Each is returned as a targeted list and a blocked list. | | Zone and network rules | Whether zones are targeted or blocked, partner network settings, blocked labels and product categories. | | Creatives | Each variation with its landing URL, display URL, offer, status, and approval state, plus a summary count of approved, pending, rejected, and paused variations. | Where a field holds an internal id, the response also carries the readable name alongside it, so the AI can answer in plain language rather than raw ids. #### **Example prompts** * *How many active campaigns do I have?* * *Show me all paused campaigns.* * *List my campaigns in group 5, sorted by name.* * *Do I have any campaigns targeting Germany?* Results are paginated. For accounts with many campaigns, the AI will automatically handle pagination across multiple requests. ### Creating and updating Available when the connection has been granted Write access for this capability. Without it, every write returns a permission error. Existing connections stay read-only until you reconnect and set Campaigns to Write. #### **What can you ask:** * Create a campaign, including its name, ad type, pricing model, bid, targeting and creatives * Update a campaign's settings and targeting, including date range and day parting * Play or pause a campaign * Add or update creative variations, and play or pause them individually * Copy a campaign, optionally renaming it or switching its ad type * Add zones to, or remove zones from, a campaign The LLM only offers ad types, categories, pricing models and targeting options available to your account. #### **Example prompts:** * *Create a CPM banner campaign called Summer Sale, targeting Spain, bidding 0.50.* * *Add a 300x250 variation to campaign X pointing at example.com.* * *Raise the bid on campaign X to 0.80.* * *Pause the variations on campaign X.* * *Copy campaign X and target zones instead.* * Target Zones X and/or Block Zone X Every change is summarised before it is applied, so nothing is written until you confirm. #### **What to expect** | Situation | Behaviour | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | A new campaign | Created paused unless you ask for it to go live. | | A copied campaign | Keeps the original campaign's status. | | Creatives | Use assets already in your media library, referenced by id or by name. If a name matches more than one asset, you are asked which one and nothing is changed. | | Bids and budgets | Set in your account's currency. Bids below the minimum price for the country and format are rejected. | | Formats not available to you | Ad types and settings reserved to administrators, or disabled on your network, cannot be used. | | Not yet supported | Uploading assets, Smart Bid and Dynamic CPA campaigns, archiving, behavioural retargeting, interests targeting and network-specific custom targeting. | ## Sites and Zones Explore your sites and ad zones conversationally, list them, filter and search them, and dig into any single site or zone's setup, including which labels and product categories a zone blocks. This is a **publisher-only** tool. **Access:** Read or Write ### Viewing * A list of your sites or zones, filtered by status, site types or ad type, or searched by name * The zones belonging to a particular site * The full configuration of a single site or zone * Which of your zones are active **Asking about a site returns:** | Area | What is included | | -------------- | ---------------------------------------------- | | Identity | Name, id, URL, description. | | Classification | Site type (website, app, and so on), category. | | Status | Active state and approval status. | **Asking about a zone returns a much fuller configuration, covering:** | Area | What is included | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------- | | Identity | Name, id, parent site id and name. | | Format | Publisher ad type and label, size, whether the zone is responsive, and for multi-format zones the child zones and their layouts. | | Pricing | Minimum CPM, floor type (soft or hard), pricing models. | | Delivery controls | Frequency capping, impression capping, ad refresh rate, browser restrictions, fallback ads. | | Appearance | Sticky position, border and colour, text colours, font, thumbnail setting. | | Video | Pre-roll, mid-roll and post-roll settings, VAST configuration, VAST wrapper support, VMAP, CTA overlay, skip timing. | | Pop settings | Trigger method, trigger classes, delay, fallback, new tab behaviour. | | Blocking | Labels the publisher blocks, blocked product categories, compliance rules. | | Category | Main and sub category. | | Flags | Active state, inventory tracking, certification level, bid shading, BURL, ad transparency dialog. | Where a field holds an internal id, the response also carries the readable name alongside it, so the AI can answer in plain language rather than raw ids. Results are paginated, so large accounts return in batches rather than all at once. #### **Example prompts** * *Which of my zones are active?* * *What is the setup on site X?* * *List all the zones on my site X.* * *Which of my zones have a CPM floor set?* * *Show me the labels blocked on zone X.* * *List my sites that are still pending approval.* ### **Creating and updating** Available when the connection has been granted Write access for this capability. Without it, every write returns a permission error. Connections authorized before access levels were introduced are read-only until you reconnect. #### **What can you ask:** * Create a site * Create a zone of any supported ad type, including RTB, native widget, in-video VAST, web push, in-page push and multi-format * Update a site's name, description or category * Update a zone's settings, or move it to a different site #### **Example prompts:** * *Create a new site for example.com under the Entertainment category.* * *Add a banner zone, 300x250, to my site X.* * *Rename zone 1234567 to Homepage Top.* * *Move zone 1234567 to my other site.* Every change is summarised before it is applied, so nothing is written until you confirm. #### **What to expect** | Situation | Behaviour | | ------------------------------ | ------------------------------------------------------------------------------------------ | | A new site | May be returned as unverified, in which case verification is completed in the admin panel. | | Changing a site's category | Returns the site to pending approval. | | A site's URL and type | Set at creation and cannot be changed afterwards. | | A zone's ad type | Set at creation and cannot be changed afterwards. | | Banner and mobile banner zones | Require a size. | | RTB zones | Require an ad exchange partner, and do not take a size. | | Formats not available to you | Formats reserved to administrators, or disabled on your network, cannot be created. | ## **Reference: tools by capability** If your AI client displays raw tool names, this is the full list. | Tool | Capability | Access | | ----------------------------------- | ----------------------- | ---------------- | | get\_advertiser\_global\_statistics | Statistics (advertiser) | Read | | get\_publisher\_global\_statistics | Statistics (publisher) | Read | | get\_campaigns | Campaigns | Read | | get\_campaign | Campaigns | Read | | get\_campaign\_groups | Campaigns | Read | | get\_zone\_targeting\_options | Campaigns | Read | | get\_minimum\_prices | Campaigns | Read | | create\_campaign | Campaigns | Write | | update\_campaign | Campaigns | Write | | copy\_campaign | Campaigns | Write | | add\_campaign\_variation | Campaigns | Write | | play\_campaign\_variations | Campaigns | Write | | pause\_campaign\_variations | Campaigns | Write | | add\_campaign\_zones | Campaigns | Write | | remove\_campaign\_zones | Campaigns | Write | | get\_sites | Sites and zones | Read | | get\_site | Sites and zones | Read | | get\_zones | Sites and zones | Read | | get\_zone | Sites and zones | Read | | create\_site | Sites and zones | Write | | update\_site | Sites and zones | Write | | create\_zone | Sites and zones | Write | | update\_zone | Sites and zones | Write | | get\_collection | Supporting | Always available | ## Public skills repository Alongside the MCP Server, ExoClick has access to a [**public repository of pre-built skills**](https://github.com/EXADS/ai-skills), which are optimised prompts and workflows designed for common advertising tasks. These skills give you a head start with proven approaches for tasks like daily performance analysis, campaign optimisation reviews, and reporting. | Skill | What it does | | --------------------------- | --------------------------------------------------------------------------------------------------------------------- | | daily-top-campaigns | Shows your top-performing advertiser campaigns for a single day. | | statistics-analysis | Analyses advertiser performance over a date range and compares it to a prior window. | | fetch-advertiser-statistics | Fetches advertiser statistics by any supported dimensions, usable on its own or as a building block for other skills. | | fetch-publisher-statistics | Fetches publisher statistics by any supported dimensions. | Skills are entirely optional. The MCP Server works with any prompt or question you write yourself. The skills repository is simply there to help you get started faster and benefit from workflows that have been tested and refined by the ExoClick team. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.exoclick.com/mcp/exoclick-mcp-tools.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.