These are the tools your AI tool gets when you connect the Superside MCP. To set it up, see Use Superside MCP with your AI tool.
Last updated: October 24, 2026. 89 tools.
Tool | What it does | Access | Tool name |
Account balance for a month | Balance of one account for a month, never a later one, as plain numbers in | Reads only |
|
Add a file to a brand folder | Adds an already-uploaded file to a brand asset folder (e.g. Logos, Guidelines, Fonts) | Makes changes |
|
Add competitors | Add Meta pages as this workspace's competitors. | Makes changes |
|
Bind one visual format | Bind one visual format to the account: its rules, its options, the parts its ads are made of and style references. | Makes changes |
|
Brief customer info | Returns customer info for brief generation for the authenticated customer: company (account) name, customer timezone as UTC offset, and preferred brief verbosity (SHORT, MEDIUM, LONG) | Reads only |
|
Check audience evaluation status | Check whether an audience evaluation started with superads_audience_evaluate_start has finished. | Reads only |
|
Check Brand Models connection | Connectivity probe for the Brand Models Private MCP. | Reads only |
|
Check brief generation status | Check whether a brief generation run has finished. | Reads only |
|
Check brief render status | Check whether a run started with superads_brief_render_start has finished. | Reads only |
|
Check competitor discovery status | Check whether a run started with superads_competitors_discover_start has finished. | Reads only |
|
Check concept generation status | Check whether a concept generation run started with superads_concept_generate_start has finished. | Reads only |
|
Check generation status | Check the current status and progress of an image generation, variant, or upscale job. | Reads only |
|
Check report rendering status | Check whether a report started with superads_report_start has finished rendering. | Reads only |
|
Check research run status | Check whether a research run started with superads_research_start has finished. | Reads only |
|
Check social listening status | Check whether a social listening run started with superads_social_listening_start has finished. | Reads only |
|
Check subreddit discovery status | Check whether a run started with superads_social_targets_discover_start has finished. | Reads only |
|
Check visual clusters extraction status | Check whether an extraction started with superads_visual_clusters_start has finished. | Reads only |
|
Check visual search status | Check whether a visual search started with superads_visual_search_start has finished. | Reads only |
|
Complete a file upload | Marks an upload as complete after its bytes were sent to the upload URL. | Makes changes |
|
Compose one ad plan | Compose ONE complete ad plan from a visual format, a product and a brief: the design as markup, the reference ads it follows, brand marks and crops, saved. | Makes changes |
|
Covered services and fast turnaround | Services one account can request on its plan in a month, each with coverage: IN_PLAN is paid from the balance, OUT_OF_PLAN is billed separately at a higher rate. | Reads only |
|
Create a draft project | Creates a superside draft project. | Makes changes |
|
Create a draft project from a brief | Creates a superside draft project from an already-written brief. | Makes changes |
|
Create image variants | Create variations of an existing generated image inside the current conversation or thread session. | Makes changes |
|
Delivered project files | Returns the final delivered files of a project as downloadable assets. | Reads only |
|
Discover a brand's competitors | Find the brands a brand competes with and map each to its Meta pages, to choose which to add as this workspace's competitors. | Makes changes |
|
Enable or disable a watched subreddit | Turn scanning on or off for one existing target without changing its identity. | Makes changes |
|
File information | Returns file information for the given file info UUIDs including name, download URL, mime type, and content length | Reads only |
|
Find a brand's Meta pages | Find the Meta pages that belong to one brand: an agent searches the web and the Superads brand search and returns result.pages, best first, each with id, name, platform, url, reason (why it matched)… | Makes changes |
|
Find a SuperAds workspace by name | Find the SuperAds workspaces you can act in, by name. | Reads only |
|
Find subreddits to follow | Find the Reddit communities (subreddits) this workspace should follow for a topic â use it for questions like "which subreddits should I follow or track for X?". | Makes changes |
|
Find the formats, angles or offers sources share | Find the visual formats, messaging angles or offers a set of sources share: the best ads of each of your own ad accounts and competitor brands you name are pooled, grouped by the dimension you choose… | Makes changes |
|
Generate images | Generate images using one or more brand contexts (up to 3). | Makes changes |
|
Get a brand's discovered competitors | Retrieve the competitors a finished superads_competitors_discover_start run found. | Reads only |
|
Get a reference image upload form | Get a signed upload form for ONE local image to use as a reference or asset in superads_brief_generation_start. | Makes changes |
|
Get audience evaluation | Retrieve a completed audience evaluation. | Reads only |
|
Get image session | Get full details of a specific image generation session, including all entries and generated images with CDN URLs. | Reads only |
|
Get research findings | Retrieve the findings of a completed research run. | Reads only |
|
Get social listening insights | Retrieve canonical insights from a completed Reddit social listening run. | Reads only |
|
Get subreddits to follow | Retrieve the Reddit communities a finished superads_social_targets_discover_start run recommends. | Reads only |
|
Get the generated ad concepts | Retrieve the concepts from a completed concept generation run. | Reads only |
|
Get the generated creative brief | Retrieve the complete structured creative brief from a completed run. | Reads only |
|
Get the rendered ad | Retrieve the ad a finished superads_brief_render_start run produced: a link to it (artifact.url, a self-contained SVG that opens in any browser), whether the review approved it, its open defects, and… | Reads only |
|
Get the rendered report | Retrieve the report rendered by a completed superads_report_start run. | Reads only |
|
Get the shared formats, angles or offers | Retrieve the clusters found by a completed superads_visual_clusters_start run. | Reads only |
|
Get the visual search matches | Retrieve the matches found by a completed superads_visual_search_start run. | Reads only |
|
Group brands' ads into shared families | Group several accounts' ads into ONE set of families, so formats, messaging angles, offers or video hooks can be compared across them: every account's stored clusters are pooled and named as shared… | Makes changes |
|
Init a file upload | Creates an upload target for one file. | Makes changes |
|
List a workspace's competitors | List the Meta pages this workspace tracks as competitors and, unless include_followed is false, the other pages it follows; competitors come first. | Reads only |
|
List brand models | List or search available brand contexts for image generation. | Reads only |
|
List image sessions | List image generation sessions for the current user. | Reads only |
|
List the account's visual formats | Read the ad account's usable visual formats, each with its description, its member count and a few example ads. | Makes changes |
|
List the competitor-research fields | List the fields superads_ad_library_query can project, filter, sort and bucket on: the competitor-research model over the Meta Ad Library ads of library brands (any onboarded library brand, tracked… | Makes changes |
|
List watched subreddits | List the subreddits this workspace watches for social listening â the registry the scheduled Reddit scan reads. | Reads only |
|
List what the account promotes | Read everything the ad account promotes â its products and other entities â with what its ads say about each. | Makes changes |
|
My accounts | Returns all accounts (companies) the authenticated customer can access, including account ID, account name, and whether it is the default account | Reads only |
|
My role on this account | Returns the authenticated customer's role in their current account (company), including account ID, account name, and role (e.g. Admin, User, Light User) | Reads only |
|
Original customer brief | Returns the original brief as submitted by the customer, before any edits by the project team | Reads only |
|
Project brief | Returns the current project brief (the editable version used by the project team) for a project | Reads only |
|
Project chat messages | Returns newest chat messages for a project | Reads only |
|
Project estimate and usage | Subscription view of one project: best and high estimate on the current plan, the same estimate on the plan it started under when the plan changed since, and consumption per month and in total. | Reads only |
|
Project usage for a month | What each project of one account consumed in a month, never a later one, largest first, as plain numbers in | Reads only |
|
Query competitors' ads | Query the Meta Ad Library ads of library brands: one row per ad (project adId and ad-level dimensions), or counts per dimension value (project dimensions plus measures such as ads). | Makes changes |
|
Read one adgen tool job | Read one adgen tool job by its job_id: running; done, with the tool's result â ok holds the card, or error holds a typed refusal such as an unknown product â and media_url when the call produced… | Reads only |
|
Remove competitors | Remove Meta pages from this workspace's competitors and stop following them. | Makes changes |
|
Render a report from research runs, briefs and external evidence | Write a report from research runs, creative briefs, social-listening runs, and synthetic-audience evaluations that have already finished, without running them again. | Makes changes |
|
Report a problem with a SuperAds tool | Report a problem with a SuperAds tool so the SuperAds team can fix it: an error, a wrong, empty or surprising result, a run that stalled, a description that misled you, or something the user needed… | Makes changes |
|
Resolve one promoted entity | Resolve one product or other promoted entity with every statement the account's ads make about it â the claims an ad may repeat. | Makes changes |
|
Search ads by format, angle or offer | Search the ads of your own ad accounts and competitor brands you name for a visual format, messaging angle or offer you describe in words - e.g. 'a meme' or 'side-by-side before and after comparison'… | Makes changes |
|
Search projects | Generic project search tool for projects the authenticated customer has access to. | Reads only |
|
Search the account's ads for real elements | Search the account's shipped ads for real elements â logos, products, people, images and graphics â at the account's newest tagging and scan. | Makes changes |
|
Send a project chat message | Sends a chat message into a project's chat room as the authenticated customer. | Makes changes |
|
Start ad concept generation | Start a concept generation run: adgen's harness ideates ad concepts from a brief, binds each to a visual format, authors a wireframe and RENDERS an image for it. | Makes changes |
|
Start an image session | Create the shared image generation session for the current user conversation or thread. | Makes changes |
|
Start creative brief generation | Start structured creative brief generation for a product or offer. | Makes changes |
|
Start Reddit social listening run | Start a Reddit social listening run on a topic or brand. | Makes changes |
|
Start rendering a brief as an ad | Turn a finished creative brief into one ad: a self-contained SVG with live text over at most one generated scene, checked and reviewed before it is delivered. | Makes changes |
|
Start SuperAds research run | Start a research run on the customer's Superads workspace data and competitors. | Makes changes |
|
Start synthetic audience evaluation | Ask a synthetic panel how an ad concept will land, before it is produced. | Makes changes |
|
Stop watching a subreddit | Remove a subreddit from this workspace's social listening targets. | Makes changes |
|
Subscription plan | Plan of one account for a month: plan name, monthly allowance, price, renewal and the packages active in the month. | Reads only |
|
Superside team on my account | Returns Superside staff assigned to the authenticated customer's account, including name, email, role, and whether they are the primary contact for that role | Reads only |
|
Tasks needing your attention | Returns tasks waiting for customer's attention | Reads only |
|
Team balance for a month | Balance of one team of one account for a month, never a later one; omit teamId for the shared balance. | Reads only |
|
Team budgets | How one account splits its balance between teams, as configured now. | Reads only |
|
Turn one plan into an image | Turn one plan into pixels with adgen's image model. | Makes changes |
|
Unread chat messages | Returns the most recent unread chat messages in a company for the logged-in user | Reads only |
|
Upscale image | Upscale an existing generated image to higher resolution inside the current conversation or thread session. | Makes changes |
|
Watch a subreddit | Add a subreddit to this workspace's social listening targets, or re-enable one that was removed. | Makes changes |
|