{"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/cep-finder","title":"CEP Finder","description":"Give one keyword (category, product, service or brand) and it finds category entry points (CEPs) from real search paths, related searches, search volumes, SERPs and AI Overviews, then ranks them in a report. Marketers and brand managers use it to choose campaign situations and messages. Data comes from ListeningMind DaaS search behavior and Google results for Korea, Japan and the US.","version":"1.0.0","serverInfo":{"name":"CEP Finder","version":"1.0.0"},"protocolVersion":"2025-06-18","remotes":[{"type":"streamable-http","url":"https://daas-cep.listeningmind.ai/mcp"}],"tools":[{"name":"resolve_sense","description":"Fixes what the keyword means before a build and proposes the category anchor, seed keywords, entry-situation (trigger) candidates and exclude terms that a person can edit. Use it before start_build when the keyword may be ambiguous or when you want to edit seeds; pass the (edited) result as `sense` to start_build. One LLM call, no Data API credits, usually 15-40 seconds."},{"name":"get_estimate","description":"Expected Data API credits and Lima for one run, for the signed-in member: {credits, low, high, lima, lima_low, lima_high, n, basis, depth, gl}. When the same member ran the same keyword, market and depth in the last 24 hours, it subtracts the expected reuse of that result (basis=cache, the plain figure under plain); otherwise it is the median of recent actual charges for the market and depth. The same figure the run's start response returns and the hub reserves. Signed-in members only. The public plain estimate is the app's own GET /api/estimate (open to everyone, not a hub tool)."},{"name":"start_build","description":"Starts a CEP Finder run that collects related searches, search paths, volumes and SERPs for the keyword, synthesizes category entry points (CEPs) and scores them into a report. Returns job_id and status (queued or running); poll get_job until done. Runs execute one at a time; if 3 jobs are already running or queued the server answers HTTP 429. Spends many Data API credits (see cost) and LLM calls; ask the person before calling."},{"name":"get_job","description":"Returns one job's status (queued, running, done, error, canceled), its progress log (stage, pct, msg, t), error text, and when done the run_id with report_url and json_url. Repeat until status is done, error or canceled, then read the result with get_report or get_cep_map."},{"name":"list_jobs","description":"Lists jobs that are running or queued plus up to 4 jobs finished in the last 10 minutes, with keyword, depth, percent, queue position, error and report_url, and the active count against the limit of 3. Use it to see whether a new build will be accepted or to find a job started elsewhere."},{"name":"cancel_job","description":"Cancels a job. A queued job is removed at once; a running job stops at its next progress report. Credits already spent are not returned. Returns job_id, status and cancel_requested."},{"name":"get_report","description":"Returns the saved HTML report of a finished run: CEP map, priorities, triage, brand links, time series, evidence and readiness. Pass lang to re-render the same saved data in another language at no credit cost; download=1 returns it as an attachment."},{"name":"get_cep_map","description":"Returns the machine-readable cep_map.json of a finished run: meta (keyword, topic, sense, market, credits spent), the CEP list with metrics and evidence, triage and readiness verdict. Use this instead of the HTML report when you need the numbers."},{"name":"download_report_pdf","description":"Converts the run's report to PDF with headless Chromium (cached per paper size) and returns the file. Use for sharing or printing; the first conversion can take up to about a minute."},{"name":"list_runs","description":"Lists saved runs, newest first, with run_id, input keyword, topic, sense, market (gl), report language, focal brand, competitors, number of CEPs, readiness, credits spent, depth and creation time. Use it to find an existing analysis before starting a new one."},{"name":"prepare_rerun","description":"Loads the exact input conditions of a saved run without starting anything: params (keyword, topic, gl, focal_brand, competitors, depth, lang, sense) and sense_panel (the confirmed meaning) plus credits_prev. To actually re-run, pass params to start_build after the person confirms the credit cost; this is how the UI re-runs."},{"name":"delete_run","description":"Permanently deletes a saved run and its report files. Returns {ok: true}, or 404 if the run does not exist."},{"name":"get_validation_report","description":"Returns the post-hoc validation report (HTML) built from all saved runs; it is regenerated when a newer run exists. Use it to judge how reliable CEP Finder outputs have been. Reads saved runs only."},{"name":"rerun_run","description":"Starts a new run with the stored inputs of an earlier run (the whole pipeline again, data is fetched fresh). Spends Data API credits like start_build. Use prepare_rerun to read the inputs first; poll get_job with the returned job_id."},{"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-cep.listeningmind.ai/llms.txt"},"docs":"https://daas-cep.listeningmind.ai/llms.txt"}