> 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. #### **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 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. ## 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. \[Table, three columns: Tool, Capability, Access. Tool names in code style. * get\_advertiser\_global\_statistics | Statistics (advertiser) | Read * get\_publisher\_global\_statistics | Statistics (publisher) | Read * get\_campaigns | Campaigns | Read * get\_campaign | Campaigns | Read * 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 | 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\_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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.