callDataAnalyst
ChatGPTDelegate cross-source data analysis to a specialized Data Analyst sub-agent. The sub-agent runs internal tools in parallel (experiments, campaigns, research, personas, optional web search), evaluates findings through the Magnitude / Confidence / Consistency framework, and returns an answer-first synthesis. Heavy path (~20-60s); suited to questions that require connecting dots across sources rather than a direct single-source lookup. Suited for: - Cross-experiment / cross-campaign synthesis ("what works across all our tests?", "what drives our audience?") - "Which variant won?" / "How did experiment X perform?" / "What was the uplift?" - Cross-source correlation (performance + research + persona) - Strategic / "so what" questions, root-cause analysis, conflict resolution Returned fields: - core_finding: one-sentence lead fact with an inline citation ref. - performance_evidence: prose summary of experiment + campaign findings, with inline citation refs and scope qualifiers. - contextual_evidence: prose summary of research + persona findings, with inline refs and segment qualifiers. - synthesis_status: "Alignment" / "Conflict" / "Gap" between sources. - synthesis_analysis: strategic "so what" synthesis with inline refs. - sources: structured citation entries for the refs ([E1] experiments, [C2] campaigns, [R3] research, [I4] interviews) actually cited in the prose fields. Each entry carries title and objectId; experiments may additionally include a deep-link URL when available, and research/interview entries may include sourceSummary, researchData, and sourceReference.
callHeatseekerAIAgent
ChatGPTHeatseeker'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.
chatWithPersonaAgent
ChatGPTChat 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.
createAudienceDraft
ChatGPTBuilds 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.
createExperimentDraft
ChatGPTBuilds 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).
getAllExperiments
ChatGPTLists completed and published experiments in the workspace, sorted with the newest first. Can filter by title (case-insensitive substring match) or experimentId (exact match). By default returns only live experiments. Use experimentType to include synthetic or all. Returns a summary including ID, title, variant performance data, and isSimulation flag. Supports pagination via 'limit' and 'skip'.
getExperimentDraft
ChatGPTReads 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.
getTopAds
ChatGPTReturns a flat, pre-sorted list of imported campaign ads (META / LINKEDIN) ranked by any metric, with full creative info. Does NOT include Heatseeker experiment variants. Suited for top/bottom N ads by metric, best/worst performing ads, image vs video comparison (filter via isVideo), or ads in a specific time window (with dateRange).
getWorkspaceCatalog
ChatGPTLists a workspace's products and saved audiences — the productId and audienceId values you pass to createExperimentDraft. Call this to discover valid ids before drafting an experiment whenever the workspace might have more than one product or audience (createExperimentDraft only auto-resolves when there is exactly one of each). Personas have their own listPersonas tool.
listExperimentDrafts
ChatGPTLists 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.
listPersonas
ChatGPTList all personas in a workspace. Returns each persona's ID, name, title, summary, location, age, and interest. The persona ID is the input that chatWithPersonaAgent expects.
searchCampaignHistory
ChatGPTSearch the workspace's imported campaign history (META / LINKEDIN) and return campaigns with nested ad variants, metrics, creative info, and aggregate totals. Uses semantic search when variant is provided. Suited for: - "show me my campaigns", "spend this month", "compare campaigns / which underperforming" - "active last week" or other time-windowed queries (with dateRange) - "campaigns about X" / theme-based queries (with variant for semantic match)
searchWorkspaces
ChatGPTSearch 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.
callDataAnalyst
ClaudecallHeatseekerAIAgent
ClaudechatWithPersonaAgent
ClaudecreateAudienceDraft
ClaudecreateExperimentDraft
ClaudegetAllExperiments
ClaudegetExperimentDraft
ClaudegetTopAds
ClaudegetWorkspaceCatalog
ClaudelistExperimentDrafts
ClaudelistPersonas
ClaudesearchCampaignHistory
ClaudesearchWorkspaces
Claude