{"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/pulse-finder","title":"Next Item","description":"Next Item. It harvests candidate keywords from seed keywords or categories, measures gender and age share, 48-month search volume and SERP / AI Overview presence, and ranks the things that are surging, new or over-indexing in the chosen segment. Marketers, merchandisers and content planners use it to find next-quarter openings and risks. Data comes from the ListeningMind Data API (trend_finder, intent_finder, keyword_info, SERP, path_finder, cluster_finder). Markets: Korea, Japan, US; the gender and age split exists only for Korea.","version":"1.0.0","serverInfo":{"name":"Next Item","version":"1.0.0"},"protocolVersion":"2025-06-18","remotes":[{"type":"streamable-http","url":"https://daas-pulse.listeningmind.ai/mcp"}],"tools":[{"name":"get_config","description":"Returns the option lists the input form uses: markets, categories per market, genders, ages, periods, purposes, credit cap, drill-down cost, and the current account credit balance. Free."},{"name":"interpret_brief","description":"Turns a plain-language request into run parameters (gender, age, category, seeds, period, purpose) and returns each field with the phrase it came from and the fields it could not read. One paid LLM call, no Data API credits, a few seconds. Fields not supported by the text stay null."},{"name":"suggest_seeds","description":"Proposes extra seed keywords that open different demand clusters than the given one, for the chosen segment. Uses intent_finder and keyword_info plus one LLM call. About 260 Data API credits (cap 780); the fetched data is cached and reused by the run. Takes 10-40 seconds."},{"name":"estimate_credits","description":"Returns a rough Data API credit estimate for the given run parameters ({credits}). Computed locally, no API calls. Cached calls in the real run cost nothing, so the actual spend is often lower."},{"name":"start_run","description":"Starts a background run that harvests candidate keywords from the seeds, measures segment share and 48-month volume, classifies them with an LLM and ranks surging, emerging, newcomer and over-indexing things for the segment. Returns {run_id, url}. Poll get_run until status is done or error. Typically 2-3 minutes and roughly 1,000-15,000 Data API credits (capped by credit_cap)."},{"name":"get_run","description":"Returns one run: status (running, done, error), progress {stage, pct, steps}, credits spent, params and, when done, the full result (entities, trending, emerging, newcomers, overindex, harvest, coverage). Repeat until status is done or error."},{"name":"list_runs","description":"Lists recent runs with run_id, status, credits, created_at, url, segment label, category, free_text, period and market."},{"name":"get_run_evidence","description":"For a finished run, returns Data API calls per endpoint (calls, credits, cache hits), harvest and coverage details, skipped items, baseline share, score weights and seeds. Free."},{"name":"explain_keyword","description":"Explains why one keyword or entity from a finished run is rising: search paths, co-search clusters and SERP, summarised by an LLM with numbers checked against the data. standard costs about 3,830 Data API credits, deep (adds a 6-month path comparison) about 5,480. The result is stored, so asking again is free. 20-90 seconds."},{"name":"get_keyword_brief_markdown","description":"Returns {keyword, markdown}: a one-page brief for a keyword that was already drilled into with explain_keyword. Renders stored data only, no credits. 404 if the drill-down was not run."},{"name":"get_keyword_brief_html","description":"Returns the printable HTML page of a keyword brief (needs explain_keyword first). download=1 adds an attachment header. Free."},{"name":"download_keyword_brief_pdf","description":"Downloads the keyword brief as a PDF (needs explain_keyword first). Returns 503 when the server has no headless Chrome; then use get_keyword_brief_html. Free."},{"name":"get_report_markdown","description":"Returns the full run report as Markdown text. Free. 404 until the run is done."},{"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 run report as a self-contained HTML file. Free."},{"name":"download_trends_csv","description":"Downloads the ranked trend rows as CSV (UTF-8 with BOM). Free."},{"name":"download_run_json","description":"Returns the raw result object of a finished run as JSON. Free."},{"name":"rerun_run","description":"Starts a new run with the same parameters as an earlier run. Returns {run_id, url, from}. Same cost and duration as start_run, minus cached calls."},{"name":"delete_run","description":"Deletes a run and its stored drill-downs. Cannot be undone."},{"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-pulse.listeningmind.ai/llms.txt"},"docs":"https://daas-pulse.listeningmind.ai/llms.txt"}