KnowMapped is an MCP server published by com.knowmapped, hosted at mcp.knowmapped.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 16 tools, including get_knowmapped_update_schema, search_knowmapped_maps, get_knowmapped_map, get_knowmapped_map_adjacency, get_knowmapped_wheel_branch.
Search, retrieve, create, and update visual knowledge maps in a user's KnowMapped account.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Return the authoritative, versioned schema, graph_type_operations and examples for atomic KnowMapped concept-map and Futures Wheel patches. Call this before constructing an update instead of guessing operation or field names.
No parameters.
{
"name": "get_knowmapped_update_schema",
"title": "Get the KnowMapped update schema",
"description": "Return the authoritative, versioned schema, graph_type_operations and examples for atomic KnowMapped concept-map and Futures Wheel patches. Call this before constructing an update instead of guessing operation or field names.",
"inputSchema": {
"type": "object",
"title": "get_knowmapped_update_schemaArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Search maps available to the connected KnowMapped account. Use this when a user refers to a saved map or wants to find prior concepts; existing ownership and sharing permissions are enforced server-side.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query | string |
{
"name": "search_knowmapped_maps",
"title": "Search KnowMapped maps",
"description": "Search maps available to the connected KnowMapped account. Use this when a user refers to a saved map or wants to find prior concepts; existing ownership and sharing permissions are enforced server-side.",
"inputSchema": {
"type": "object",
"title": "search_knowmapped_mapsArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"query": {
"type": "string",
"title": "Query",
"default": ""
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve an authorized map with independent node_offset, edge_offset, and page_size parameters. Canonical IDs are always retained in projected nodes and edges even when include_nodes or include_edges omits id. Use summary for statistics without graph content or compact for token-efficient fields. Search results return copy-safe map references so UUIDs should not be typed manually.
| Parameter | Type | Description |
|---|---|---|
| map_id * | string | |
| include | string | one of ["full","compact","summary"] |
| page_size | integer | Maximum nodes and maximum edges returned in this page (1-200). |
| edge_offset | integer | Zero-based offset for the independently paginated edge collection. |
| node_offset | integer | Zero-based offset for the independently paginated node collection. |
| include_edges | string | |
| include_nodes | string |
{
"name": "get_knowmapped_map",
"title": "Get a KnowMapped map",
"description": "Retrieve an authorized map with independent node_offset, edge_offset, and page_size parameters. Canonical IDs are always retained in projected nodes and edges even when include_nodes or include_edges omits id. Use summary for statistics without graph content or compact for token-efficient fields. Search results return copy-safe map references so UUIDs should not be typed manually.",
"inputSchema": {
"type": "object",
"title": "get_knowmapped_mapArguments",
"required": [
"map_id"
],
"properties": {
"map_id": {
"type": "string",
"title": "Map Id"
},
"include": {
"enum": [
"full",
"compact",
"summary"
],
"type": "string",
"title": "Include",
"default": "full"
},
"page_size": {
"type": "integer",
"title": "Page Size",
"default": 100,
"maximum": 200,
"minimum": 1,
"examples": [
100
],
"description": "Maximum nodes and maximum edges returned in this page (1-200)."
},
"edge_offset": {
"type": "integer",
"title": "Edge Offset",
"default": 0,
"minimum": 0,
"examples": [
0,
100
],
"description": "Zero-based offset for the independently paginated edge collection."
},
"node_offset": {
"type": "integer",
"title": "Node Offset",
"default": 0,
"minimum": 0,
"examples": [
0,
100
],
"description": "Zero-based offset for the independently paginated node collection."
},
"include_edges": {
"type": "string",
"title": "Include Edges",
"default": ""
},
"include_nodes": {
"type": "string",
"title": "Include Nodes",
"default": ""
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Return one concept and its directly connected concepts and relationships without retrieving the full graph. Provide node_id or an exact unique label.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| map_id * | string | |
| offset | integer | |
| node_id | any | |
| exact_label | any |
{
"name": "get_knowmapped_map_adjacency",
"title": "Get KnowMapped map adjacency",
"description": "Return one concept and its directly connected concepts and relationships without retrieving the full graph. Provide node_id or an exact unique label.",
"inputSchema": {
"type": "object",
"title": "get_knowmapped_map_adjacencyArguments",
"required": [
"map_id"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 100
},
"map_id": {
"type": "string",
"title": "Map Id"
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"node_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Node Id",
"default": null
},
"exact_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Exact Label",
"default": null
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read a wheel consequence, its ancestors, inherited domain and paginated descendants, including collapsed content. Omit the node reference to start at the central change. Compact keeps causal metadata; full adds descriptions, resources and provenance.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| map_id * | string | |
| offset | integer | |
| include | string | one of ["compact","full"] |
| node_id | any | |
| exact_label | any |
{
"name": "get_knowmapped_wheel_branch",
"title": "Get a Futures Wheel branch",
"description": "Read a wheel consequence, its ancestors, inherited domain and paginated descendants, including collapsed content. Omit the node reference to start at the central change. Compact keeps causal metadata; full adds descriptions, resources and provenance.",
"inputSchema": {
"type": "object",
"title": "get_knowmapped_wheel_branchArguments",
"required": [
"map_id"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 100,
"maximum": 200,
"minimum": 1
},
"map_id": {
"type": "string",
"title": "Map Id"
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"minimum": 0
},
"include": {
"enum": [
"compact",
"full"
],
"type": "string",
"title": "Include",
"default": "compact"
},
"node_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Node Id",
"default": null
},
"exact_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Exact Label",
"default": null
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Return an import-ready .know JSON file for an authorized concept map or Futures Wheel. Serialize file as UTF-8 JSON under filename. Includes every node, including collapsed branches, presentation and provenance; does not publish or create a map. Visual exports remain in the app.
| Parameter | Type | Description |
|---|---|---|
| map_id * | string |
{
"name": "export_knowmapped_map",
"title": "Export a KnowMapped file",
"description": "Return an import-ready .know JSON file for an authorized concept map or Futures Wheel. Serialize file as UTF-8 JSON under filename. Includes every node, including collapsed branches, presentation and provenance; does not publish or create a map. Visual exports remain in the app.",
"inputSchema": {
"type": "object",
"title": "export_knowmapped_mapArguments",
"required": [
"map_id"
],
"properties": {
"map_id": {
"type": "string",
"title": "Map Id"
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Return layout bounds and graph statistics without returning graph content.
| Parameter | Type | Description |
|---|---|---|
| map_id * | string |
{
"name": "get_knowmapped_layout_summary",
"title": "Get KnowMapped layout summary",
"description": "Return layout bounds and graph statistics without returning graph content.",
"inputSchema": {
"type": "object",
"title": "get_knowmapped_layout_summaryArguments",
"required": [
"map_id"
],
"properties": {
"map_id": {
"type": "string",
"title": "Map Id"
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Check eligibility and credits for concept maps or Futures Wheels (graph_type), or retain a fully validated graph as a short-lived draft. The exact creation layout field is top-level graph.layout_intent, for example left-to-right. For concept maps, omission records Smart intent and complete explicit coordinates are preserved. Futures Wheels default to radial, derive positions with the wheel renderer, and reject other intents. Fields named layout, layout_type, or strategy are rejected. Drafts do not reserve credits and can be confirmed by draft ID without resending the graph.
| Parameter | Type | Description |
|---|---|---|
| graph | any | |
| idempotency_key | any |
{
"name": "preflight_knowmapped_map_creation",
"title": "Preflight KnowMapped map creation",
"description": "Check eligibility and credits for concept maps or Futures Wheels (graph_type), or retain a fully validated graph as a short-lived draft. The exact creation layout field is top-level graph.layout_intent, for example left-to-right. For concept maps, omission records Smart intent and complete explicit coordinates are preserved. Futures Wheels default to radial, derive positions with the wheel renderer, and reject other intents. Fields named layout, layout_type, or strategy are rejected. Drafts do not reserve credits and can be confirmed by draft ID without resending the graph.",
"inputSchema": {
"type": "object",
"title": "preflight_knowmapped_map_creationArguments",
"properties": {
"graph": {
"anyOf": [
{
"type": "object",
"examples": [
{
"edges": [
{
"id": "source-review",
"label": "informs",
"source": "source",
"target": "review"
}
],
"nodes": [
{
"id": "source",
"label": "Source"
},
{
"id": "review",
"label": "Review"
}
],
"title": "Research flow",
"layout_intent": "left-to-right"
},
{
"edges": [
{
"id": "cause",
"label": "",
"source": "change",
"target": "effect"
}
],
"nodes": [
{
"id": "change",
"label": "A central change",
"semantic_data": {
"collapsed": false,
"futures_wheel": {
"order": 0,
"status": "assumption",
"domains": [
{
"id": "health",
"label": "Public health"
}
],
"parent_id": null
}
}
},
{
"id": "effect",
"label": "A possible consequence",
"semantic_data": {
"collapsed": false,
"futures_wheel": {
"order": 1,
"status": "possible",
"domain_id": "health",
"parent_id": "change"
}
}
}
],
"title": "Possible consequences",
"graph_type": "futures_wheel",
"layout_intent": "radial"
}
],
"required": [
"nodes",
"edges"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"edges": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source",
"target"
],
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"style": {
"type": "object"
},
"source": {
"type": "string"
},
"target": {
"type": "string"
},
"routing": {
"type": "string"
},
"strength": {
"type": "string"
},
"semantic_data": {
"type": "object",
"description": "Knowledge/concept maps do not expose Evidence and classification fields. Do not ask users for or invent semantic roles, node tags, relationship type, basis/assertion status, review status, supporting evidence, or source-reference classifications for concept maps. Use clear labels, node descriptions and resource links for context and sources. Existing semantic metadata remains supported for compatibility: preserve it when editing, without adding classification defaults. Structural metadata such as grouping and map links remains supported. Futures Wheel evidence controls and typed causal metadata are unchanged."
}
},
"additionalProperties": false
}
},
"nodes": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string"
},
"icon": {
"type": "string"
},
"label": {
"type": "string"
},
"is_core": {
"type": "boolean"
},
"position": {
"type": "object"
},
"resources": {
"type": "array"
},
"importance": {
"type": "string"
},
"description": {
"type": "string"
},
"semantic_data": {
"type": "object",
"description": "Knowledge/concept maps do not expose Evidence and classification fields. Do not ask users for or invent semantic roles, node tags, relationship type, basis/assertion status, review status, supporting evidence, or source-reference classifications for concept maps. Use clear labels, node descriptions and resource links for context and sources. Existing semantic metadata remains supported for compatibility: preserve it when editing, without adding classification defaults. Structural metadata such as grouping and map links remains supported. Futures Wheel evidence controls and typed causal metadata are unchanged. For futures_wheel: futures_wheel.order is 0 for the unique center or 1–5 for consequences; futures_wheel.parent_id is null for the center, otherwise the source node ID. Center futures_wheel.domains contains up to 32 {id,label} entries; only order 1 may set domain_id. collapsed is a boolean beside futures_wheel. status is possible/assumption/evidence (not a fact check)."
}
},
"additionalProperties": false
}
},
"title": {
"type": "string",
"minLength": 1
},
"graph_type": {
"enum": [
"concept",
"futures_wheel"
],
"type": "string",
"default": "concept",
"description": "Choose a graph type explicitly. Futures wheels require exactly one order-0 center, parent_id/order metadata on every consequence, and causal edges forming one tree through five orders. Only radial layout is supported for wheels."
},
"description": {
"type": "string"
},
"presentation": {
"type": "object",
"description": "Non-layout visual settings. Layout belongs in top-level layout_intent.",
"additionalProperties": true
},
"layout_intent": {
"enum": [
"smart",
"left-to-right",
"top-to-bottom",
"radial",
"clustered",
"grid",
"hierarchical",
"declutter",
"manual"
],
"type": "string",
"default": "smart",
"description": "Requested semantic layout. Use this exact top-level field. If omitted, KnowMapped automatically applies Smart layout unless every node supplies explicit x/y coordinates; complete explicit coordinates are preserved as manual positioning. For futures_wheel the default is radial, positions are always derived, and non-radial intent is rejected."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"title": "Graph",
"default": null
},
"idempotency_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Idempotency Key",
"default": null
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Validate or create a concept map or Futures Wheel. Set graph.graph_type explicitly. Wheels require causal parent/order metadata and use the same radial geometry as the editor; only radial layout is allowed. Manual wheel creation is included in Free; MCP creation uses the normal MCP entitlement and credit policy. Concept maps: Specify requested layout only as top-level graph.layout_intent. When omitted, requested_layout and resolved_strategy are smart, but [0,0] placeholders are retained for the map client to lay out on first draw; layout_application is client-first-draw. Complete explicit coordinates are preserved instead. Set validate_only=true to check the exact final graph schema, layout, capacity, links, and credits without creating a map, charging credits, or reserving the idempotency key. For credit-bearing creation, show the quoted charge, then confirm the retained draft only after explicit approval.
| Parameter | Type | Description |
|---|---|---|
| graph * | object | |
| validate_only | boolean | |
| idempotency_key * | string | |
| confirm_credit_use | boolean |
{
"name": "create_knowmapped_map",
"title": "Create a KnowMapped map",
"description": "Validate or create a concept map or Futures Wheel. Set graph.graph_type explicitly. Wheels require causal parent/order metadata and use the same radial geometry as the editor; only radial layout is allowed. Manual wheel creation is included in Free; MCP creation uses the normal MCP entitlement and credit policy. Concept maps: Specify requested layout only as top-level graph.layout_intent. When omitted, requested_layout and resolved_strategy are smart, but [0,0] placeholders are retained for the map client to lay out on first draw; layout_application is client-first-draw. Complete explicit coordinates are preserved instead. Set validate_only=true to check the exact final graph schema, layout, capacity, links, and credits without creating a map, charging credits, or reserving the idempotency key. For credit-bearing creation, show the quoted charge, then confirm the retained draft only after explicit approval.",
"inputSchema": {
"type": "object",
"title": "create_knowmapped_mapArguments",
"required": [
"graph",
"idempotency_key"
],
"properties": {
"graph": {
"type": "object",
"examples": [
{
"edges": [
{
"id": "source-review",
"label": "informs",
"source": "source",
"target": "review"
}
],
"nodes": [
{
"id": "source",
"label": "Source"
},
{
"id": "review",
"label": "Review"
}
],
"title": "Research flow",
"layout_intent": "left-to-right"
},
{
"edges": [
{
"id": "cause",
"label": "",
"source": "change",
"target": "effect"
}
],
"nodes": [
{
"id": "change",
"label": "A central change",
"semantic_data": {
"collapsed": false,
"futures_wheel": {
"order": 0,
"status": "assumption",
"domains": [
{
"id": "health",
"label": "Public health"
}
],
"parent_id": null
}
}
},
{
"id": "effect",
"label": "A possible consequence",
"semantic_data": {
"collapsed": false,
"futures_wheel": {
"order": 1,
"status": "possible",
"domain_id": "health",
"parent_id": "change"
}
}
}
],
"title": "Possible consequences",
"graph_type": "futures_wheel",
"layout_intent": "radial"
}
],
"required": [
"nodes",
"edges"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"edges": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source",
"target"
],
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"style": {
"type": "object"
},
"source": {
"type": "string"
},
"target": {
"type": "string"
},
"routing": {
"type": "string"
},
"strength": {
"type": "string"
},
"semantic_data": {
"type": "object",
"description": "Knowledge/concept maps do not expose Evidence and classification fields. Do not ask users for or invent semantic roles, node tags, relationship type, basis/assertion status, review status, supporting evidence, or source-reference classifications for concept maps. Use clear labels, node descriptions and resource links for context and sources. Existing semantic metadata remains supported for compatibility: preserve it when editing, without adding classification defaults. Structural metadata such as grouping and map links remains supported. Futures Wheel evidence controls and typed causal metadata are unchanged."
}
},
"additionalProperties": false
}
},
"nodes": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string"
},
"icon": {
"type": "string"
},
"label": {
"type": "string"
},
"is_core": {
"type": "boolean"
},
"position": {
"type": "object"
},
"resources": {
"type": "array"
},
"importance": {
"type": "string"
},
"description": {
"type": "string"
},
"semantic_data": {
"type": "object",
"description": "Knowledge/concept maps do not expose Evidence and classification fields. Do not ask users for or invent semantic roles, node tags, relationship type, basis/assertion status, review status, supporting evidence, or source-reference classifications for concept maps. Use clear labels, node descriptions and resource links for context and sources. Existing semantic metadata remains supported for compatibility: preserve it when editing, without adding classification defaults. Structural metadata such as grouping and map links remains supported. Futures Wheel evidence controls and typed causal metadata are unchanged. For futures_wheel: futures_wheel.order is 0 for the unique center or 1–5 for consequences; futures_wheel.parent_id is null for the center, otherwise the source node ID. Center futures_wheel.domains contains up to 32 {id,label} entries; only order 1 may set domain_id. collapsed is a boolean beside futures_wheel. status is possible/assumption/evidence (not a fact check)."
}
},
"additionalProperties": false
}
},
"title": {
"type": "string",
"minLength": 1
},
"graph_type": {
"enum": [
"concept",
"futures_wheel"
],
"type": "string",
"default": "concept",
"description": "Choose a graph type explicitly. Futures wheels require exactly one order-0 center, parent_id/order metadata on every consequence, and causal edges forming one tree through five orders. Only radial layout is supported for wheels."
},
"description": {
"type": "string"
},
"presentation": {
"type": "object",
"description": "Non-layout visual settings. Layout belongs in top-level layout_intent.",
"additionalProperties": true
},
"layout_intent": {
"enum": [
"smart",
"left-to-right",
"top-to-bottom",
"radial",
"clustered",
"grid",
"hierarchical",
"declutter",
"manual"
],
"type": "string",
"default": "smart",
"description": "Requested semantic layout. Use this exact top-level field. If omitted, KnowMapped automatically applies Smart layout unless every node supplies explicit x/y coordinates; complete explicit coordinates are preserved as manual positioning. For futures_wheel the default is radial, positions are always derived, and non-radial intent is rejected."
}
},
"additionalProperties": false
},
"validate_only": {
"type": "boolean",
"title": "Validate Only",
"default": false
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key"
},
"confirm_credit_use": {
"type": "boolean",
"title": "Confirm Credit Use",
"default": false
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Transactionally confirm a preflighted creation by draft ID. Success definitively returns map_id and revision. A failed transaction preserves the draft for retry, and retrying a committed success returns the same result without charging again. Use get_knowmapped_map_creation_result after a timeout or malformed response.
| Parameter | Type | Description |
|---|---|---|
| draft_id * | string | |
| confirm_credit_use | boolean |
{
"name": "confirm_knowmapped_map_creation",
"title": "Confirm KnowMapped map creation",
"description": "Transactionally confirm a preflighted creation by draft ID. Success definitively returns map_id and revision. A failed transaction preserves the draft for retry, and retrying a committed success returns the same result without charging again. Use get_knowmapped_map_creation_result after a timeout or malformed response.",
"inputSchema": {
"type": "object",
"title": "confirm_knowmapped_map_creationArguments",
"required": [
"draft_id"
],
"properties": {
"draft_id": {
"type": "string",
"title": "Draft Id"
},
"confirm_credit_use": {
"type": "boolean",
"title": "Confirm Credit Use",
"default": false
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Recover the definitive state of a map creation without creating a map or charging credits. Provide exactly one draft_id or the original idempotency_key. A succeeded result includes the canonical map ID and revision.
| Parameter | Type | Description |
|---|---|---|
| draft_id | any | |
| idempotency_key | any |
{
"name": "get_knowmapped_map_creation_result",
"title": "Get a KnowMapped map creation result",
"description": "Recover the definitive state of a map creation without creating a map or charging credits. Provide exactly one draft_id or the original idempotency_key. A succeeded result includes the canonical map ID and revision.",
"inputSchema": {
"type": "object",
"title": "get_knowmapped_map_creation_resultArguments",
"properties": {
"draft_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Draft Id",
"default": null
},
"idempotency_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Idempotency Key",
"default": null
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Validate or atomically update an editable concept map or Futures Wheel. For wheels use add_consequence, update_consequence, move_branch, remove_branch (confirmed cascade), set_branch_collapsed, upsert_domain, remove_domain, assign_domain and layout_wheel. Orders, causal edges and radial geometry are derived; concept operations are rejected. For concept maps: Accepted operations are update_map, add_node, update_node, remove_node, add_edge, update_edge, remove_edge, replace_edges, and layout_nodes; get_knowmapped_update_schema is the authoritative versioned contract. Use id for identifiers, title for the map title, and layout_nodes with strategy, spacing, groups, and optional flow. Node references accept IDs, earlier temp_id values, or exact unique labels. Edge references accept IDs or semantic source/target/current-relationship matches. validate_only returns a corrected executable normalized_patch, all detectable errors and warnings, layout positions and bounds, a patch summary, publication state, and current revision without changing data. On a stale write, revalidate the same patch at current_revision, then submit the returned normalized_patch.
| Parameter | Type | Description |
|---|---|---|
| map_id * | string | |
| operations * | array | One atomic patch. Node references accept IDs, declared temp IDs, or {"label":"Exact unique label"}. |
| validate_only | boolean | |
| idempotency_key * | string | |
| expected_revision * | integer |
{
"name": "update_knowmapped_map",
"title": "Update a KnowMapped map",
"description": "Validate or atomically update an editable concept map or Futures Wheel. For wheels use add_consequence, update_consequence, move_branch, remove_branch (confirmed cascade), set_branch_collapsed, upsert_domain, remove_domain, assign_domain and layout_wheel. Orders, causal edges and radial geometry are derived; concept operations are rejected. For concept maps: Accepted operations are update_map, add_node, update_node, remove_node, add_edge, update_edge, remove_edge, replace_edges, and layout_nodes; get_knowmapped_update_schema is the authoritative versioned contract. Use id for identifiers, title for the map title, and layout_nodes with strategy, spacing, groups, and optional flow. Node references accept IDs, earlier temp_id values, or exact unique labels. Edge references accept IDs or semantic source/target/current-relationship matches. validate_only returns a corrected executable normalized_patch, all detectable errors and warnings, layout positions and bounds, a patch summary, publication state, and current revision without changing data. On a stale write, revalidate the same patch at current_revision, then submit the returned normalized_patch.",
"inputSchema": {
"type": "object",
"title": "update_knowmapped_mapArguments",
"required": [
"map_id",
"expected_revision",
"operations",
"idempotency_key"
],
"properties": {
"map_id": {
"type": "string",
"title": "Map Id"
},
"operations": {
"type": "array",
"items": {
"$id": "https://knowmapped.com/schemas/mcp/map-patch/2026-10-26.1",
"oneOf": [
{
"type": "object",
"examples": [
{
"op": "add_consequence",
"label": "A possible consequence",
"parent": {
"label": "Central change"
},
"status": "possible",
"temp_id": "new-effect"
}
],
"required": [
"op",
"label",
"parent",
"temp_id"
],
"properties": {
"op": {
"const": "add_consequence"
},
"icon": {
"type": "string"
},
"label": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"parent": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"status": {
"enum": [
"possible",
"assumption",
"evidence"
],
"description": "Evidence is a user assertion, not an automated fact check."
},
"temp_id": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"domain_id": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"resources": {
"type": "array"
},
"description": {
"type": "string",
"maxLength": 20000
},
"semantic_data": {
"type": "object",
"description": "Provenance/assertion metadata only; structural wheel fields use typed operations."
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"op": "add_edge",
"label": "supports",
"source": {
"label": "Source material"
},
"target": "new-concept"
}
],
"required": [
"op",
"source",
"target"
],
"properties": {
"op": {
"const": "add_edge"
},
"label": {
"type": "string"
},
"style": {
"type": "object"
},
"source": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"target": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"routing": {
"type": "string"
},
"strength": {
"type": "string"
},
"semantic_data": {
"type": "object",
"description": "Knowledge/concept maps do not expose Evidence and classification fields. Do not ask users for or invent semantic roles, node tags, relationship type, basis/assertion status, review status, supporting evidence, or source-reference classifications for concept maps. Use clear labels, node descriptions and resource links for context and sources. Existing semantic metadata remains supported for compatibility: preserve it when editing, without adding classification defaults. Structural metadata such as grouping and map links remains supported. Futures Wheel evidence controls and typed causal metadata are unchanged."
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"op": "add_node",
"label": "New concept",
"temp_id": "new-concept"
}
],
"required": [
"op",
"label",
"temp_id"
],
"properties": {
"op": {
"const": "add_node"
},
"icon": {
"type": "string"
},
"label": {
"type": "string"
},
"is_core": {
"type": "boolean"
},
"temp_id": {
"type": "string"
},
"position": {
"type": "object",
"required": [
"x",
"y"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
},
"additionalProperties": false
},
"resources": {
"type": "array"
},
"importance": {
"type": "string"
},
"description": {
"type": "string"
},
"semantic_data": {
"type": "object",
"description": "Knowledge/concept maps do not expose Evidence and classification fields. Do not ask users for or invent semantic roles, node tags, relationship type, basis/assertion status, review status, supporting evidence, or source-reference classifications for concept maps. Use clear labels, node descriptions and resource links for context and sources. Existing semantic metadata remains supported for compatibility: preserve it when editing, without adding classification defaults. Structural metadata such as grouping and map links remains supported. Futures Wheel evidence controls and typed causal metadata are unchanged."
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"id": "first-order-id",
"op": "assign_domain",
"domain_id": "health"
}
],
"required": [
"op",
"domain_id",
"id"
],
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"op": {
"const": "assign_domain"
},
"domain_id": {
"type": [
"string",
"null"
],
"maxLength": 80
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"op": "layout_nodes",
"flow": "Source → Draft → Concepts → Review",
"groups": {
"Evidence": [
{
"label": "Source material"
}
]
},
"spacing": 220,
"strategy": "hierarchical"
}
],
"required": [
"op",
"strategy"
],
"properties": {
"op": {
"const": "layout_nodes"
},
"flow": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
}
}
],
"description": "Optional reading order, either concept references or labels separated by → or ->."
},
"groups": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
}
}
},
"spacing": {
"type": "number",
"maximum": 800,
"minimum": 80
},
"strategy": {
"enum": [
"smart",
"left-to-right",
"top-to-bottom",
"manual",
"grid",
"radial",
"hierarchical",
"clustered",
"declutter"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"op": "layout_wheel"
}
],
"required": [
"op"
],
"properties": {
"op": {
"const": "layout_wheel"
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"id": "consequence-id",
"op": "move_branch",
"parent": "new-parent-id"
}
],
"required": [
"op",
"id",
"parent"
],
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"op": {
"const": "move_branch"
},
"parent": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"domain_id": {
"type": [
"string",
"null"
],
"maxLength": 80
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"id": "consequence-id",
"op": "remove_branch",
"confirm": true
}
],
"required": [
"op",
"confirm",
"id"
],
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"op": {
"const": "remove_branch"
},
"confirm": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"id": "health",
"op": "remove_domain",
"confirm": true
}
],
"required": [
"op",
"confirm",
"id"
],
"properties": {
"id": {
"type": "string"
},
"op": {
"const": "remove_domain"
},
"confirm": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"id": "relationship-id",
"op": "remove_edge",
"confirm": true
}
],
"required": [
"op",
"confirm",
"id"
],
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "object",
"required": [
"source",
"target"
],
"properties": {
"source": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"target": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"relationship": {
"type": "string"
}
},
"description": "Semantic relationship match. relationship matches the current edge label when supplied.",
"additionalProperties": false
}
]
},
"op": {
"const": "remove_edge"
},
"confirm": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"id": {
"label": "Obsolete concept"
},
"op": "remove_node",
"confirm": true
}
],
"required": [
"op",
"confirm",
"id"
],
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"op": {
"const": "remove_node"
},
"confirm": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"op": "replace_edges",
"add": [
{
"label": "produces",
"source": {
"label": "Draft"
},
"target": {
"label": "Concepts"
}
}
],
"remove": [
{
"source": {
"label": "Draft"
},
"target": {
"label": "Review"
},
"relationship": "precedes"
}
],
"confirm": true
}
],
"required": [
"op",
"add",
"confirm",
"remove"
],
"properties": {
"op": {
"const": "replace_edges"
},
"add": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"target"
],
"properties": {
"label": {
"type": "string"
},
"style": {
"type": "object"
},
"source": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"target": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"routing": {
"type": "string"
},
"strength": {
"type": "string"
},
"semantic_data": {
"type": "object"
}
},
"additionalProperties": false
}
},
"remove": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "object",
"required": [
"source",
"target"
],
"properties": {
"source": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"target": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"relationship": {
"type": "string"
}
},
"description": "Semantic relationship match. relationship matches the current edge label when supplied.",
"additionalProperties": false
}
]
}
},
"confirm": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"id": "consequence-id",
"op": "set_branch_collapsed",
"collapsed": true
}
],
"required": [
"op",
"collapsed",
"id"
],
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"op": {
"const": "set_branch_collapsed"
},
"collapsed": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"id": "consequence-id",
"op": "update_consequence",
"description": "Context and source reasoning"
}
],
"required": [
"op",
"id"
],
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"op": {
"const": "update_consequence"
},
"icon": {
"type": "string"
},
"label": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"status": {
"enum": [
"possible",
"assumption",
"evidence"
],
"description": "Evidence is a user assertion, not an automated fact check."
},
"resources": {
"type": "array"
},
"description": {
"type": "string",
"maxLength": 20000
},
"semantic_data": {
"type": "object",
"description": "Provenance/assertion metadata only; structural wheel fields use typed operations."
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"id": "relationship-id",
"op": "update_edge",
"label": "strengthens"
}
],
"required": [
"op",
"id"
],
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "object",
"required": [
"source",
"target"
],
"properties": {
"source": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"target": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"relationship": {
"type": "string"
}
},
"description": "Semantic relationship match. relationship matches the current edge label when supplied.",
"additionalProperties": false
}
]
},
"op": {
"const": "update_edge"
},
"label": {
"type": "string"
},
"style": {
"type": "object"
},
"source": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"target": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"routing": {
"type": "string"
},
"strength": {
"type": "string"
},
"semantic_data": {
"type": "object",
"description": "Knowledge/concept maps do not expose Evidence and classification fields. Do not ask users for or invent semantic roles, node tags, relationship type, basis/assertion status, review status, supporting evidence, or source-reference classifications for concept maps. Use clear labels, node descriptions and resource links for context and sources. Existing semantic metadata remains supported for compatibility: preserve it when editing, without adding classification defaults. Structural metadata such as grouping and map links remains supported. Futures Wheel evidence controls and typed causal metadata are unchanged."
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"op": "update_map",
"title": "Revised map title"
}
],
"required": [
"op"
],
"properties": {
"op": {
"const": "update_map"
},
"title": {
"type": "string"
},
"color_mode": {
"type": "string"
},
"description": {
"type": "string"
},
"view_settings": {
"type": "object"
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"id": {
"label": "Source material"
},
"op": "update_node",
"description": "Revised description"
}
],
"required": [
"op",
"id"
],
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "Canonical node ID or a temp_id declared by add_node."
},
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"op": {
"const": "update_node"
},
"icon": {
"type": "string"
},
"label": {
"type": "string"
},
"is_core": {
"type": "boolean"
},
"position": {
"type": "object",
"required": [
"x",
"y"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
},
"additionalProperties": false
},
"resources": {
"type": "array"
},
"importance": {
"type": "string"
},
"description": {
"type": "string"
},
"semantic_data": {
"type": "object",
"description": "Knowledge/concept maps do not expose Evidence and classification fields. Do not ask users for or invent semantic roles, node tags, relationship type, basis/assertion status, review status, supporting evidence, or source-reference classifications for concept maps. Use clear labels, node descriptions and resource links for context and sources. Existing semantic metadata remains supported for compatibility: preserve it when editing, without adding classification defaults. Structural metadata such as grouping and map links remains supported. Futures Wheel evidence controls and typed causal metadata are unchanged."
}
},
"additionalProperties": false
},
{
"type": "object",
"examples": [
{
"id": "health",
"op": "upsert_domain",
"label": "Public health"
}
],
"required": [
"op",
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"op": {
"const": "upsert_domain"
},
"label": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
}
],
"discriminator": {
"propertyName": "op"
},
"schema_version": "2026-10-26.1"
},
"title": "Operations",
"examples": [
[
{
"op": "add_node",
"label": "New finding",
"temp_id": "finding-1",
"position": {
"x": 100,
"y": 200
}
},
{
"op": "add_edge",
"label": "supports",
"source": {
"label": "Existing concept"
},
"target": "finding-1"
}
],
[
{
"op": "layout_nodes",
"spacing": 220,
"strategy": "hierarchical"
}
],
[
{
"id": {
"label": "Obsolete concept"
},
"op": "remove_node",
"confirm": true
}
]
],
"description": "One atomic patch. Node references accept IDs, declared temp IDs, or {\"label\":\"Exact unique label\"}."
},
"validate_only": {
"type": "boolean",
"title": "Validate Only",
"default": false
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key"
},
"expected_revision": {
"type": "integer",
"title": "Expected Revision"
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Make a map public or private at its current revision. Obtain the user's explicit permission to publish and confirmation that they have the right to publish before setting copyright_acknowledged=true; never infer it from map content. Initial publication creates a moderated public snapshot and generated preview. Making private removes the snapshot and disables live viewing. Setting an already-public map public does not publish edits: use publish_knowmapped_map. Reuse the same idempotency_key and identical arguments after a dropped response; a different request needs a new key. A pending_review result means publication has not succeeded. On a revision conflict, retrieve the map and reconsider before retrying.
| Parameter | Type | Description |
|---|---|---|
| map_id * | string | |
| is_public * | boolean | |
| idempotency_key * | string | |
| expected_revision * | integer | |
| copyright_acknowledged | boolean |
{
"name": "set_knowmapped_map_visibility",
"title": "Set KnowMapped map visibility",
"description": "Make a map public or private at its current revision. Obtain the user's explicit permission to publish and confirmation that they have the right to publish before setting copyright_acknowledged=true; never infer it from map content. Initial publication creates a moderated public snapshot and generated preview. Making private removes the snapshot and disables live viewing. Setting an already-public map public does not publish edits: use publish_knowmapped_map. Reuse the same idempotency_key and identical arguments after a dropped response; a different request needs a new key. A pending_review result means publication has not succeeded. On a revision conflict, retrieve the map and reconsider before retrying.",
"inputSchema": {
"type": "object",
"title": "set_knowmapped_map_visibilityArguments",
"required": [
"map_id",
"expected_revision",
"is_public",
"idempotency_key"
],
"properties": {
"map_id": {
"type": "string",
"title": "Map Id"
},
"is_public": {
"type": "boolean",
"title": "Is Public"
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key",
"maxLength": 200,
"minLength": 1
},
"expected_revision": {
"type": "integer",
"title": "Expected Revision",
"minimum": 1
},
"copyright_acknowledged": {
"type": "boolean",
"title": "Copyright Acknowledged",
"default": false
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Enable or disable public live viewing for an owned published concept map or Futures Wheel. Enable only at the user's explicit request: live viewers see ongoing saved edits, not just the published snapshot. Requires the existing account entitlement and maps:publish permission. Does not publish a private map or invite collaborators. Reuse an identical idempotency key after a dropped response.
| Parameter | Type | Description |
|---|---|---|
| map_id * | string | |
| live_enabled * | boolean | |
| idempotency_key * | string | |
| expected_revision * | integer |
{
"name": "set_knowmapped_live_view",
"title": "Set KnowMapped live viewing",
"description": "Enable or disable public live viewing for an owned published concept map or Futures Wheel. Enable only at the user's explicit request: live viewers see ongoing saved edits, not just the published snapshot. Requires the existing account entitlement and maps:publish permission. Does not publish a private map or invite collaborators. Reuse an identical idempotency key after a dropped response.",
"inputSchema": {
"type": "object",
"title": "set_knowmapped_live_viewArguments",
"required": [
"map_id",
"expected_revision",
"live_enabled",
"idempotency_key"
],
"properties": {
"map_id": {
"type": "string",
"title": "Map Id"
},
"live_enabled": {
"type": "boolean",
"title": "Live Enabled"
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key",
"maxLength": 200,
"minLength": 1
},
"expected_revision": {
"type": "integer",
"title": "Expected Revision",
"minimum": 1
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Publish or republish completed edits to an already-public map when the user requests it. Use the revision returned by the final edit or a fresh retrieval. Applies the same permissions, locks, moderation, and restrictions as browser publishing and generates the public preview. Reuse the same idempotency_key and identical arguments after a dropped response. Returns published revision and sync state; pending review or sync must not be reported as a fully delivered publication. On a revision conflict, retrieve the map and reconsider before retrying. To publish a private map first use set_knowmapped_map_visibility with explicit copyright acknowledgement.
| Parameter | Type | Description |
|---|---|---|
| map_id * | string | |
| idempotency_key * | string | |
| expected_revision * | integer |
{
"name": "publish_knowmapped_map",
"title": "Publish KnowMapped map edits",
"description": "Publish or republish completed edits to an already-public map when the user requests it. Use the revision returned by the final edit or a fresh retrieval. Applies the same permissions, locks, moderation, and restrictions as browser publishing and generates the public preview. Reuse the same idempotency_key and identical arguments after a dropped response. Returns published revision and sync state; pending review or sync must not be reported as a fully delivered publication. On a revision conflict, retrieve the map and reconsider before retrying. To publish a private map first use set_knowmapped_map_visibility with explicit copyright acknowledgement.",
"inputSchema": {
"type": "object",
"title": "publish_knowmapped_mapArguments",
"required": [
"map_id",
"expected_revision",
"idempotency_key"
],
"properties": {
"map_id": {
"type": "string",
"title": "Map Id"
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key",
"maxLength": 200,
"minLength": 1
},
"expected_revision": {
"type": "integer",
"title": "Expected Revision",
"minimum": 1
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Check public snapshot revision, moderation and delivery without loading graph content. Requires maps:publish and editable-map access. Revision differences mean content may have changed, since operational changes also advance revisions. After a timeout retry the original publication with the same idempotency_key; use this tool to check current delivery separately.
| Parameter | Type | Description |
|---|---|---|
| map_id * | string |
{
"name": "get_knowmapped_publication_status",
"title": "Get KnowMapped publication status",
"description": "Check public snapshot revision, moderation and delivery without loading graph content. Requires maps:publish and editable-map access. Revision differences mean content may have changed, since operational changes also advance revisions. After a timeout retry the original publication with the same idempotency_key; use this tool to check current delivery separately.",
"inputSchema": {
"type": "object",
"title": "get_knowmapped_publication_statusArguments",
"required": [
"map_id"
],
"properties": {
"map_id": {
"type": "string",
"title": "Map Id"
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}KnowMapped stores structured knowledge maps made of concepts and relationships. Search or retrieve maps only from the connected user's authorized account. Create a persistent map only after the user explicitly asks to preserve, visualize, organize, or map their ideas. Update a map only after retrieving its current revision; use one atomic patch. Knowledge/concept maps do not expose Evidence and classification fields. Do not ask users for or invent semantic roles, node tags, relationship type, basis/assertion status, review status, supporting evidence, or source-reference classifications for concept maps. Use clear labels, node descriptions and resource links for context and sources. Existing semantic metadata remains supported for compatibility: preserve it when editing, without adding classification defaults. Structural metadata such as grouping and map links remains supported. Futures Wheel evidence controls and typed causal metadata are unchanged. Read resource://knowmapped/capabilities before creating a map; successful MCP map creation costs one credit and failed validation costs zero. Map edits do not update public snapshots. When the user requests publication, use set_knowmapped_map_visibility for initial publication or withdrawal and publish_knowmapped_map to publish completed edits at the current revision. Never infer copyright acknowledgement. For credit-bearing creation, preflight first, show the user the charge and remaining balance, then confirm by draft ID without resending the graph.
Names, descriptions and schemas were written by the server and are shown as data.