Heatseeker

Chat with a specific persona in a workspace. The persona agent has knowledge from experiments, campaigns, research, and persona brain modules, and answers questions from the persona's perspective with insights grounded in their background and learnings. Suited for: - Direct conversation with a specific persona - Persona-perspective interpretation of marketing data - Insights grounded in the persona's background, interests, and learned behaviors Requires a personaId, which is surfaced by the listPersonas tool. Messages are text-only (no attachments). Up to 20 messages for multi-turn context.

chatWithPersonaAgent

Builds a DRAFT audience from a caller-supplied description of who to reach, and returns a link for a human to review it in the app. Heatseeker's specialist owns the craft: it writes the strategic definition, extracts structured attributes, articulates why the audience matters, derives a name, and resolves the definition into real Meta, LinkedIn or TikTok targeting with a reach estimate, on the platforms the workspace has connected, or on all three when it has none. It NEVER marks the audience as ready: confirming the definition and choosing Mark as ready are deliberate human steps on the review page. Draft fields save separately; saving alone does not make the audience available for experiments. Read `targeting` for what each platform resolved; a platform the definition cannot reach reports `no_match`, which is expected and not an error. Launching needs the platform's ad account connected; building does not. Supply `strategicDefinition` only to relay wording the END USER themselves provided — do not author it yourself; the specialist writes it, and ships anything you relay verbatim.

createAudienceDraft

Builds a complete, ready-to-review experiment DRAFT from a caller-specified hypothesis: the goal, the audience/product, and the variants (each variant's focus is the angle it tests — the test subject). Heatseeker's specialist owns the craft: it writes doctrine-bound ad copy for every variant, attaches the first creative (the most brief-relevant brand-library image, else a fresh generation), seeds recommended budget/duration, and returns a resumable draft link plus a launch-readiness report. It NEVER launches — launch stays a human step on the review page. Copy fields (headline/primaryText/imageText) must be OMITTED unless relaying copy the end user themselves provided or approved — do not author ad copy into this call; the specialist writes it (and reviews anything supplied).

createExperimentDraft

Reads one experiment DRAFT in full by its session id: the goal, product, audience, run mode, every variant (focus + copy + whether a creative is attached), destination, seeded budget/duration, and a launch-readiness report (`canLaunch` plus the `unmet` checklist of what still stands between the draft and launch) with a `resumeUrl` deep link. Get the `sessionId` from listExperimentDrafts or a createExperimentDraft result. Read-only — it never launches or changes anything.

getExperimentDraft

Lists a workspace's products, saved audiences and own brands: the productId, audienceId and brandId values you pass to createExperimentDraft. When there are several brands, ask the user which brand the experiment is for. When the workspace Library is on, it also lists the workspace's competitors. Call this to discover valid ids before drafting an experiment whenever the workspace might have more than one product, audience or brand (createExperimentDraft only auto-resolves when there is exactly one of each). Personas have their own listPersonas tool.

getWorkspaceCatalog

Heatseeker's marketing-consultant sub-agent. Has scoped access to the workspace's experiments, campaigns, research, personas, brand voice, inline image attachments, and competitive landscape — plans and runs internal read-only tools to answer. Suited for: - Strategic recommendations or persona-aware interpretation grounded in the workspace's data - Cross-source synthesis across experiments, campaigns, research, and personas - Creative deliverables in the workspace's brand voice (ad copy, briefs, landing pages, positioning) - Multi-turn conversations with carried context (up to 20 messages) Higher latency and cost than direct data-retrieval tools. Attachments: inline base64, max 5 per call, 5 MB each, 20 MB total.

callHeatseekerAIAgent

Lists the workspace's in-progress experiment DRAFTS (created in chat, in the app, or via the createExperimentDraft tool), newest first. Each entry summarizes one draft: its display name, run mode (LIVE / SYNTHETIC / UNDECIDED), current authoring phase, experiment type, variant count, what created it, created/updated timestamps, whether it is launch-ready (`canLaunch`) with a count of outstanding requirements (`unmetCount`), and a `resumeUrl` deep link to review it. Use it to find a draft's `sessionId` before reading it in full with getExperimentDraft. Read-only — it never launches or changes anything.

listExperimentDrafts

List all personas in a workspace with lightweight profile summaries (identity, demographics, motivations, pain points). Each persona's ID can be passed to chatWithPersonaAgent to start a conversation.

listPersonas

Search workspaces by name or list workspaces the caller belongs to. When `query` is empty, returns the caller's workspaces. When `query` is provided, searches by name. Each result includes the workspaceId required by other tools in this server.

searchWorkspaces