Tool Reference
The Aims MCP server exposes a focused set of tools, grouped by what they do. You rarely need to name them yourself — the assistant picks the right one — but knowing the menu helps you write better prompts and understand what an action will cost. Discovery and brand/product tools are free and instant. Create tools spend credits. Acquisition tools spend credits and are daily-capped.
Discovery (free, instant, read-only)
These read content that is already in your Aims index. They never trigger an external fetch and never count against your daily cap.
| Tool | What it does |
|---|---|
| aims_search_inspiration | Semantic (meaning-based) search across all indexed inspiration — emails, images, videos, and social posts. Returns a compact shortlist of candidates to inspect. |
| aims_browse_competitor_content | Lists one tracked competitor's already-ingested content for a single platform (Meta ads, Instagram, TikTok, LinkedIn, website media), ranked by performance. The instant path to "top performer from competitor X." |
| aims_list_competitors | Lists the competitors you already track, with the platform handles on file. Resolves a name like "competitor X" to a stable id. |
| aims_add_competitor | Manually adds one specific competitor (name/website + optional Facebook/Instagram/TikTok/LinkedIn) to a brand. Free and instant — use aims_discover_competitors to have AI find competitors for you instead. |
| aims_get_asset | Opens ONE asset in full so the assistant can perceive it: image inlined, post/email body text, or a video's transcript plus per-scene captions and poster frame. |
| aims_get_brand_voice | Loads one brand's voice summary so the assistant can stay on-brand when writing or copying content. |
Brand & product (free, instant)
| Tool | What it does |
|---|---|
| aims_list_brands | Lists your brand profiles, each flagged with whether it has a voice profile. Usually the first call, since most tools are brand-scoped. |
| aims_create_brand | Creates a new brand WITHOUT auto-analyzing a website, so your agent can author the voice manually instead of relying on Aims extraction. |
| aims_set_brand_voice | Manually writes or updates a brand's voice (summary, persona, identity, audience, positioning, value props, tone do's/don'ts, sample posts). Field-level merge; this is the voice the copy tools use. |
| aims_list_products | Lists your saved product images (your catalog) so the assistant can pick a product to use as the hero subject for generation. |
| aims_add_product | Adds a product to your catalog by image URL (URL-only; idempotent on re-add). Use it to register a product image you found so it can be used in generation. |
Create — "copy" (spends credits)
These run the same generation pipelines as the web app and auto-spend credits from your balance on each call. They run asynchronously and return a jobId you poll with aims_get_job (recreate-post returns its text immediately).
| Tool | What it does |
|---|---|
| aims_copy_to_image | Generates a new ad image with the Image Creator, using an inspiration asset as the style reference and/or your product as the hero. Flat ~25 credits per call. |
| aims_copy_to_video | Generates a new video from a product image plus a prompt, optionally guided by a competitor reference clip. Token cost varies with duration and resolution. |
| aims_recreate_post | Rewrites a proven Reddit or LinkedIn post as an original, ready-to-publish post in your brand voice. Returns the finished text directly (text only). |
Acquisition (daily-capped, billed external fetch)
These pull NEW content into your index by fetching from external sources. Each call triggers a billed fetch on Aims' upstream accounts and spends one unit of a per-user daily budget. Use them only when the content is genuinely not in your index yet.
| Tool | What it does |
|---|---|
| aims_discover_competitors | Runs AI competitor discovery for a brand (web research + Ad-Library lookups) and writes the discovered set into your tracked competitors. Async; read results back with aims_list_competitors. |
| aims_pull_competitor_content | Fetches fresh content for a tracked competitor on a chosen platform into your index, so it becomes searchable and browsable. Async; poll with aims_get_job. |
| aims_add_social_source | Follows a Reddit subreddit or LinkedIn profile. Free by default (just saves it, like aims_add_competitor); pass pull:true to also fetch its posts now (a billed, daily-capped pull). |
Jobs
| Tool | What it does |
|---|---|
| aims_get_job | The unified poller. Pass a jobId returned by a create or pull tool to check status and, once complete, get the finished asset URL or pull results. |
You don't have to memorise these
In practice you describe the outcome you want ("write a LinkedIn post about X in my brand voice") and the assistant sequences the tools itself. The ready-made prompts in "Workflows & Prompts" encode the best sequences for you.
Can't find what you need?
Our support team is ready to help with any questions.