MCP App Store
by KeenEthics
Heatseeker icon

Heatseeker MCP Server for Claude and ChatGPT

By Heatseeker

Overview

Chat with AI personas trained on real customer behavior, monitor live ad performance, and check experiment results, directly from Claude. Heatseeker is the customer intelligence layer for modern marketing teams: AI personas and live market experiments that give you real buyer signal in days, not months. Bring proof into your Claude workflow so your next decision is grounded in customer behavior, not opinion.

How to connect

  1. Claude: Open the Heatseeker listing in the Claude connectors directory and choose Connect. Claude listing Heatseeker exposes 13 tools here.
  2. ChatGPT: Open the Heatseeker listing in the ChatGPT app directory and choose Connect. ChatGPT listing Heatseeker exposes 9 tools here.

Tools

callDataAnalyst

ChatGPT
Delegate 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

ChatGPT
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.

chatWithPersonaAgent

ChatGPT
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.

createAudienceDraft

ChatGPT
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.

createExperimentDraft

ChatGPT
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).

getAllExperiments

ChatGPT
Lists 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

ChatGPT
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.

getTopAds

ChatGPT
Returns 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

ChatGPT
Lists 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

ChatGPT
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.

listPersonas

ChatGPT
List 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

ChatGPT
Search 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

ChatGPT
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.

callDataAnalyst

Claude

callHeatseekerAIAgent

Claude

chatWithPersonaAgent

Claude

createAudienceDraft

Claude

createExperimentDraft

Claude

getAllExperiments

Claude

getExperimentDraft

Claude

getTopAds

Claude

getWorkspaceCatalog

Claude

listExperimentDrafts

Claude

listPersonas

Claude

searchCampaignHistory

Claude

searchWorkspaces

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/heatseeker"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/heatseeker)