{"mcp":"Streamable HTTP endpoint. POST JSON-RPC 2.0 here (initialize, tools/list, tools/call).","server":{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json","name":"com.listeningmind/funnel-leak","title":"Funnel Leak Finder","description":"Search journey leak finder. It samples real search paths that start from category entry keywords with path_finder, classifies every node as a brand, generic, compare, exit or channel query, and shows where journeys switch to competitor brands and where your brand captures or loses them. Brand marketers and search / content teams use it to pick points to defend or attack. Data comes from the ListeningMind Data API (path_finder, keyword_info, intent_finder, SERP / AI Overview). Markets: Korea, Japan, US.","version":"1.0.0","serverInfo":{"name":"Funnel Leak Finder","version":"1.0.0"},"protocolVersion":"2025-06-18","remotes":[{"type":"streamable-http","url":"https://daas-funnel.listeningmind.ai/mcp"}],"tools":[{"name":"get_config","description":"Returns markets, example inputs per market, comparison points, path_finder sample sizes with their credit cost, score weights, credit cap and the current account credit balance. Free."},{"name":"suggest_competitors","description":"Proposes category-qualified competitor brands grounded on the queries around the seeds, returning {competitors: [...]} with names and aliases. Uses intent_finder plus one LLM call; about 330 Data API credits per seed (cap twice that). Fetched data is cached and reused by the run."},{"name":"check_inputs","description":"Checks the run inputs against the brand / channel dictionary and returns {warnings: [{field, text}]}, e.g. a seed that is a brand, or a competitor that is really a retailer or platform. No credits, no LLM."},{"name":"estimate_credits","description":"Returns the expected Data API credits for the inputs: {credits, path_finder_calls, per_call, nodes_est, deep, aio, aio_nodes, cap, note}. Computed locally, no API calls."},{"name":"start_run","description":"Starts a background run: samples search journeys from the seeds with path_finder (now and at cmp_point), measures every node with keyword_info, classifies nodes into brand, generic, compare, exit and channel queries (rules plus LLM), reads SERP / AI Overview for top nodes and computes where journeys leak to competitors. Returns {run_id, url}. Poll get_run. Typically 2-7 minutes and about 6,000-15,000 credits with defaults."},{"name":"get_run","description":"Returns one run: status (running, done, error), progress {stage, pct, steps}, credits, params, error and, when done, the result (kpi, share, hubs, leak_edges, funnel, inbound, transition, tree, metrics, classes, serp, overview). Repeat until status is done or error."},{"name":"list_runs","description":"Lists recent runs with run_id, status, credits, created_at, url, seeds, my_brand, cmp_point, gl and deep."},{"name":"get_run_evidence","description":"For a finished run, returns the Data API calls per endpoint with calls, credits and cache hits. Free."},{"name":"get_watch_lines","description":"Marketer view of a finished run: rule-selected journey lines (conquest, uncaptured, defend, poach, strengthen) with numbers, plus the LLM wording if it was generated before for this language. Free."},{"name":"explain_watch_lines","description":"Generates and stores the LLM wording (strategy narrative) for the rule-selected watch lines. Returns {items, narrative}. Paid LLM call, no Data API credits. The stored wording also appears in report exports."},{"name":"explain_node","description":"Explains one journey node of a finished run (who arrives, where they go next, which brands win) with an LLM narrative. With fetch_serp=true and no stored SERP it first reads the SERP (about 30 credits, cap 200). Stored per keyword and language, so repeating is free."},{"name":"explain_path","description":"LLM narrative for one line of the journey tree, from the root to a node. The path must exist in result.tree. Stored, so repeating is free. No Data API credits."},{"name":"check_ai_overview","description":"Reads SERP and AI Overview for the given nodes of a finished run and stores which brands appear. Up to 30 keywords per call; 30 Data API credits per node not yet fetched (cap 900 per call). Returns the stored SERP digests."},{"name":"reclassify_node","description":"Changes the role of one node and recomputes the whole result without credits. Roles: my (own brand), comp (a competitor brand, give brand), generic, compare, exit, channel. Returns the new result."},{"name":"demote_brand","description":"Turns a name wrongly treated as a competitor (a platform or OS such as Android) into a category term: all its nodes become channel queries, it leaves the competitor list, and the result is recomputed. Your own brand cannot be demoted. No credits. Returns the new result."},{"name":"prune_brands","description":"One LLM pass over the run's brand names: retailers, carriers, marketplaces and platforms stop being competitors and their nodes become channel queries; the result is recomputed. No Data API credits. Returns the new result."},{"name":"get_node_brief_markdown","description":"Returns {keyword, markdown}: a one-page brief for a node already explained with explain_node in the same language. Free. 404 if not explained yet."},{"name":"get_node_brief_html","description":"Returns the printable HTML brief for an explained node. download=1 adds an attachment header. Free."},{"name":"download_node_brief_pdf","description":"Downloads the node brief as a PDF. Returns 503 when the server has no headless Chrome; then use get_node_brief_html. Free."},{"name":"get_report_markdown","description":"Returns the full run report as Markdown, including the watch lines and their stored wording. Free."},{"name":"get_report_preview","description":"Returns the full run report as an HTML page for viewing. Free."},{"name":"download_report_html","description":"Downloads the full report as a self-contained HTML file. Free."},{"name":"download_report_pdf","description":"Downloads the full report as PDF. Returns 503 when the server has no headless Chrome; then use get_report_preview. Free."},{"name":"download_leaks_csv","description":"Downloads the leak table as CSV (UTF-8 with BOM). Free."},{"name":"download_run_json","description":"Returns {result, raw, classes} for a finished run: the computed result, the raw sampled paths and node data, and the node classes. Free."},{"name":"rerun_run","description":"Starts a new run with the same parameters as an earlier run. Returns {run_id, url, from}. Same cost as start_run minus cached calls."},{"name":"delete_run","description":"Deletes a run and its stored data. Cannot be undone."},{"name":"list_entities","description":"Lists the learned name dictionary used to classify nodes: {items: [{name, gl, scope, type, source, updated_at}], types}. Types: brand, channel, platform, other. Free."},{"name":"add_entity","description":"Adds or updates a name in the classification dictionary so future runs treat it as the given type. scope limits it to one seed keyword's category; empty scope means global. No credits."},{"name":"delete_entity","description":"Removes a name from the classification dictionary for a market and scope ('*' = all scopes)."},{"name":"list_recent","description":"The three most recent finished runs shown on the start screen (run_id, seeds, my_brand, shares). Signed-in members only."},{"name":"get_report_robots","description":"Returns whether search engines may index this report page (index or noindex), and why: a company member's run or one set by hand is index; a customer's run, and any run that is still going, failed or came back empty, is noindex. Read only; no credits."}],"documentation":"https://daas-funnel.listeningmind.ai/llms.txt"},"docs":"https://daas-funnel.listeningmind.ai/llms.txt"}