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_list_inspiration_source_assets | Lists one tracked brand source'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 source X." |
| aims_list_inspiration_sources | Lists every inspiration source you track — brand sources (Instagram/TikTok/Meta/website) and social sources (Reddit/LinkedIn) — each tagged with its kind. Resolves a name like "source X" to a stable id. |
| aims_add_inspiration_source | Registers one inspiration source under a brand: a brand on an ad platform (instagram/tiktok/meta/website) or a Reddit/LinkedIn follow. Free and instant — use aims_discover_inspiration_sources to have AI find brand sources for you instead. |
| aims_view_inspiration_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 | One-shot brand overview: the brand description, subject count, and inspiration-source counts plus a few recent items — the whole brand in a single call (folds list_subjects + list_voices + list_inspiration_sources). |
| aims_list_creations | Lists the images and videos you have generated in Aims (your own output gallery), newest first. Filter by type or a prompt keyword. This is how the assistant sees what it has already made. |
| aims_get_account | Reads your account standing: credit balance, plan, and the remaining daily budgets for the discover / pull / social-source tools. Read-only — call it before spending. It never buys credits or changes your plan. |
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_update_voice | Updates a brand's writing voice by name — an opt-in persona copy can adopt — creating it if it doesn't exist yet. Pass a name and a description of how the voice sounds. See also aims_add_voice / aims_list_voices / aims_remove_voice / aims_extract_voice. |
| aims_list_subjects | Lists your saved subjects (products, logos, founder photos, and anything else the brand features) so the assistant can pick one to use as the hero subject for generation. |
| aims_add_subject | Adds a subject to a brand — a flexible record of any mix of an image (imageUrl), a text description, and a page link (subjectPageUrl), at least one. A physical product is a photo (+ link); a SaaS feature or service is text (+ link), no photo needed. Subjects are what aims_recreate_image / aims_recreate_video generate from. Image subjects dedupe on the URL. |
Edit & remove (free, instant)
Update or remove the things you have set up. All free and instant. Deleting a brand is the only destructive cascade, so it requires an explicit confirmation.
| Tool | What it does |
|---|---|
| aims_update_brand | Edits a brand's basic fields (name, website, product URL, description). Does not change the voice (use aims_update_voice) and does not trigger website analysis. |
| aims_delete_brand | Permanently deletes a brand. Cascades to its inspiration sources and their pulled content plus brand-scoped Klaviyo/Shopify connections; your products, generated assets and social sources are kept but unlinked. Requires confirm:true — call once without it for a preview. |
| aims_update_subject | Edits a subject (name, description, page URL, or moves it to another brand). To replace the image, upload a new one. |
| aims_remove_subject | Removes a subject so it no longer appears in your subjects (soft delete). |
| aims_update_inspiration_source | Edits a tracked brand source's name, website, or platform handles (handles are normalized for you). Social sources can't be edited — remove and re-add them. |
| aims_remove_inspiration_source | Stops tracking an inspiration source (brand source or Reddit/LinkedIn follow). Content already pulled into your index is unaffected. |
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_recreate_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_recreate_video | Generates a new video from a product image plus a prompt, optionally guided by an inspiration 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_inspiration_sources | Runs AI discovery of a brand's inspiration sources (web research + Ad-Library lookups) and writes the discovered brand sources into the brand. Async; read results back with aims_list_inspiration_sources. (Reddit/LinkedIn discovery coming soon.) |
| aims_pull_inspiration_source_assets | Fetches fresh content for a tracked brand source on a chosen platform into your index, so it becomes searchable and browsable. Async; poll with aims_get_job. |
| aims_add_inspiration_source | Registers a source (free by default). For a Reddit/LinkedIn source, pass pull:true to ALSO fetch its posts now — a billed, daily-capped pull. (The free save path is listed under Discovery.) |
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.