{"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/intent-kg","title":"Intent KG","description":"Give a topic and it builds a graph of intent elements (entry situations, choice criteria, brands, pitfalls, thresholds and more) and their relations, with evidence grades, from ListeningMind search data (related searches, clusters, search journeys, SERPs and AI Overviews). Used by marketers, product planners and AI agents that need grounded answers. Stored graphs are reused at no charge through the v1 and v2 APIs and 21 export formats. Markets: Korea, Japan, US.","version":"1.0.0","serverInfo":{"name":"Intent KG","version":"1.0.0"},"protocolVersion":"2025-06-18","remotes":[{"type":"streamable-http","url":"https://daas-intent.listeningmind.ai/mcp"}],"tools":[{"name":"lookup_topic","description":"Main agent entry point: matches a topic to the best stored finished run and returns its digest (sense, readiness, CEPs, KBFs, brands, pitfalls, conventions, heuristics, thresholds, alternatives, journey summary, limits, link to the page). Never builds. If nothing matches it returns match=false with reason no_matching_run; then use check_launch and start_build."},{"name":"lookup_or_build_topic","description":"Same as lookup_topic, but when no stored run matches it starts a build (joins a running build of the same topic if one exists). With wait=0 it returns job_id at once; with wait up to 600 seconds it waits and returns the digest if the build finishes. Spends about 35,000-37,000 Data API credits when a build starts; ask the person first. The server may disable builds through this API (reason build_disabled)."},{"name":"check_launch","description":"Before building a topic, returns finished runs of the same topic and market (up to 5, reuse them instead of rebuilding), whether a parent run's clusters can be reused for a cheaper child run, a scope verdict for the child topic, and credit estimates for a child run and a standalone standard run. Starts nothing."},{"name":"resolve_topic","description":"Stage 0: decides what the topic word means before collecting data. Returns query, ambiguous (true when several meanings are plausible) and candidates, each with id, label and seeds. If ambiguous, let the person pick a candidate, then pass sense_id, seeds and the whole result as resolution to start_build. Results are cached per topic and market for 15 minutes. One LLM call, no Data API credits."},{"name":"create_seed_plan","description":"Optional alternative to resolve_topic: widens the input into real nearby search terms using cheap lookups (two related-keyword lists plus keyword info) and proposes seeds and a journey allocation with a cost estimate. Does not build. Returns a plan with id, seeds, allocation and credits; pass the id as seed_plan_id (optionally with edited seeds) to start_build."},{"name":"get_seed_plan","description":"Returns a saved seed plan by id (topic, gl, seeds, allocation, credit estimate)."},{"name":"start_build","description":"Builds an Intent Knowledge Graph for a topic: resolves the meaning, collects related searches, clusters, search journeys and SERPs/AI Overviews, then extracts typed nodes (CEP, KBF, brands, pitfalls, thresholds and more) and relations with evidence grades. Returns job_id. If the same topic and market is already building it returns that job with joined=true; if a standard run of the same topic finished within about 20 hours it returns that run with reused=true at 0 credits (set force=true for a new snapshot). Ask the person before calling."},{"name":"get_job","description":"Returns a build's status (queued, running, done, error), progress log entries (stage, pct, msg, extra), error, duration, config, sense, seeds, stats and readiness. Repeat until status is done or error, then read the graph with get_result, get_tree or get_ontology_digest."},{"name":"get_result","description":"Returns the pipeline result of a run: ontology (nodes, edges, limits, readiness, spec check, journey verdicts), keywords, sense, seeds and stats. slim=1 drops the bulky serp, clusters, journeys and keyword detail; use it unless you need raw evidence."},{"name":"get_ontology_digest","description":"Returns a specific run in the stable v1 format. view=digest gives the same digest as lookup_topic (grouped nodes, relations, readiness, limits, journey summary); view=full returns the whole ontology graph."},{"name":"get_tree","description":"Returns the graph as a hierarchy rooted at the topic (the tree tab of the page)."},{"name":"get_journeys","description":"Returns the search journey analysis computed from the run's stored path_finder data: where searches flow before and after the topic, alternatives weighed, and verifiability."},{"name":"get_decision_pack","description":"Returns a decision evidence pack for a finished run: nodes and edges with evidence, a gate verdict, limits, sources and verification tasks, shaped for a purpose. Use it when an agent must decide what it can safely claim. 404 if the run does not exist, 409 if not completed, 410 if archived."},{"name":"get_question_pack","description":"For one real customer question, splits what the run can answer: conditions it can answer, weak ones, missing product evidence and content to improve. Give conditions explicitly when possible; otherwise they are split from the question and the gate may say NO_CONDITIONS."},{"name":"get_dossier_md","description":"Returns a readable dossier of the run in Markdown: each tree node explained with evidence, journeys and approved concepts. Best text version of a run page for an agent."},{"name":"get_dossier_html","description":"Returns the same dossier as an HTML page. By default it is laid out for printing; print=1 gives the screen layout."},{"name":"download_dossier_pdf","description":"Renders the dossier to PDF with headless Chromium and returns the file. Can take up to a few minutes for large runs."},{"name":"export_run","description":"Downloads the run's graph in one of 21 formats: json (full original), agentpack (compact conclusions, evidence and limits for agents), claims (JSONL claims with sources), jsonld, ttl, rdfxml, nt, trig, nq, owl, skos, tbox (schema), shacl (shapes), graphml, gexf, dot, neo4j (zip of CSVs), csv (triples), xlsx, md (mindmap), bundle (zip)."},{"name":"get_export_audit","description":"For each export format, measures what is kept or lost (labels, definitions, quotes, volumes, sources, edges) by checking the actual exported files. Use it to pick a format."},{"name":"download_bundle","description":"Returns one self-contained HTML file with all tabs and data of the run that opens in a browser without the server (read-only). Use it to share a run outside the internal network."},{"name":"get_run_health","description":"Scores where in the pipeline this run became thin (per-node checks and first attribution), using thresholds the pipeline already uses."},{"name":"get_shacl_report","description":"Validates the run's data graph against the SHACL shape graph (pyshacl, no inference) and returns the conformance result, violations and links to the shapes file."},{"name":"get_shacl_spec","description":"Returns the SHACL shapes (Turtle) that define valid relations, evidence and entailment rules for all runs."},{"name":"get_schema","description":"Describes the vocabulary: node types and layers, relations and their signatures, evidence grades, adjudication rules and fingerprints. Read it once to understand node types before using the graph."},{"name":"preview_conform","description":"Dry run: shows which relations in a stored run would be rewritten by the current conformance rules (off-spec count before and after, list of changes). Saves nothing."},{"name":"apply_conform","description":"Applies the current conformance rules to a stored run and saves it; each changed relation keeps its original direction and name in provenance and a note is added to limits. No credits. Requires write access."},{"name":"explain_highlight","description":"Asks the model to explain one highlight of the graph using only the facts you send (why it matters, structure, market, marketing and product implications, caveat). The model may not add numbers or brands not in facts. Results are cached per run, title and facts."},{"name":"list_reviews","description":"With run_id: nodes of that run that need human review, with features, predicted approval and any AI suggestion. Without run_id: all review decisions so far and stats."},{"name":"ai_suggest_reviews","description":"Runs AI suggestions (approved, rejected, needs_edit) for all review items of a run, in batches of 25 per LLM call. Suggestions are advisory and shown next to items in list_reviews. Requires write access."},{"name":"set_review","description":"Saves a human review decision for one node key. Requires write access; the reviewer is recorded from the token or network plus the optional name."},{"name":"list_concepts","description":"Lists concept candidates for a topic (nodes reproduced across runs of the same topic) and their approval status."},{"name":"set_concept","description":"Approves (verify) a reproduced node as a stable concept with an id, or retires an approved concept. Only keys listed by list_concepts can be verified. Requires write access."},{"name":"get_run_concepts","description":"Returns which nodes of this run map to approved concepts ({node_id: concept_id, label, version, due})."},{"name":"get_consensus","description":"Overlays recent runs of the same topic and returns how often each node and relation appears and how stable it is; nodes reproduced in at least k of n runs are marked entailed."},{"name":"list_topics","description":"Lists topics that have finished runs, to choose topics for a combined graph."},{"name":"get_related_topics","description":"Returns other topics that share identity keys with this topic, with the shared concepts as evidence."},{"name":"search_nodes","description":"Searches nodes across all runs by text (cross-run index), optionally filtered by node type."},{"name":"list_contradictions","description":"Lists pairs of claims from different runs with similar content but different numbers."},{"name":"list_runs","description":"Lists saved runs newest first (id, topic, gl, status, created, finished, duration, counts, config) plus store stats. Use topic to filter."},{"name":"list_runs_v1","description":"Light v1 list of runs (run_id, topic, gl, status, created, node and edge counts, readiness) for agents checking which topics already exist."},{"name":"get_run","description":"Returns the full record of one run: metadata, config snapshot, execution log and result. Large; prefer get_result with slim=1 or get_ontology_digest."},{"name":"get_report_robots","description":"Returns whether search engines may index this run's report pages (robots index or noindex). Read only; no credits."},{"name":"compare_runs","description":"Compares two runs of the same topic (e.g. 3 months apart): added, removed and changed nodes and relations, with a noise floor from repeated runs. Warns if topics or markets differ."},{"name":"compare_runs_v1","description":"Stable v1 version of compare_runs for agents: matches nodes by key, then by evidence keywords; no noise floor."},{"name":"plan_rerun","description":"Dry run of rerun_build: returns the inherited conditions (topic, gl, sense, seeds, scale, overrides, parent run), the config items that changed since then, the credit estimate and budget. Starts nothing."},{"name":"rerun_build","description":"Builds a new snapshot of a finished run with the same inputs (topic, gl, sense, seeds, scale, parent). Joins a running build of the same topic if any. Returns the plan plus job_id; poll get_job. Ask the person first."},{"name":"delete_run","description":"Deletes a run from the store. Requires write access. Returns {deleted, by}."},{"name":"delete_review","description":"Deletes one stored review decision by key. Changes shared data."},{"name":"clear_pins","description":"Removes pinned items. Changes shared data."},{"name":"reindex_runs","description":"Rebuilds the run index from stored files. Changes shared data; no credits."}],"documentation":"https://daas-intent.listeningmind.ai/llms.txt"},"docs":"https://daas-intent.listeningmind.ai/llms.txt"}