loadcontext | A sophisticated tool for retrieving rich, contextual information about qualitative research entities, providing structured insights tailored to different research components. When to use this tool: Retrieving detailed information about research projects, participants, interviews, and analytical elements Exploring thematic analyses and research findings Reviewing participant profiles and interview transcripts Examining code definitions and their connections to data Analyzing emerging themes and their supporting evidence Investigating research questions and related findings Reviewing analytical memos and their connections to data Preparing for coding sessions by establishing contextual understanding Exploring relationships between codes, themes, and concepts Getting a comprehensive overview of project progress and insights Tracking research activities by their current status Managing tasks based on their assigned priorities Understanding sequential relationships between research processes
Key features: Provides richly formatted, context-aware information about research entities Adapts output format based on entity type (project, participant, interview, code, theme, memo, researchQuestion) Presents both direct entity information and related research elements Shows research design, methodology, and analysis progression Tracks entity views within the current research session Formats information in a structured, readable markdown format Highlights relationships between research elements Presents supporting quotes and evidence for themes and codes Shows co-occurrence patterns between codes where available Includes status information for tracking research progress Displays priority assignments for critical research elements Visualizes sequential relationships between research processes
Parameters explained: entityName: Required - The name of the entity to retrieve context for
entityType: Optional - The type of entity being retrieved
Default: "project" Helps the system format the output appropriately Common types include: "project", "participant", "interview", "code", "theme", "memo", "researchQuestion", "status", "priority"
sessionId: Optional - The current session identifier
Each entity type returns specialized context information: Project: Shows project status, description, research design, research questions, data collection stats, recent interviews, analysis progress (themes), and findings Participant: Displays demographic information, interview history, observation records, notable quotes, and research memos Interview: Shows project affiliation, participant, date, transcript content, applied codes, and notable quotes Code: Displays definition, status, creation date, code group affiliations, supporting quotes, sources, associated themes, and code co-occurrence data Theme: Shows description, status, creation date, project affiliation, supporting codes, example quotes, and analytical memos Memo: Displays topic, date, project affiliation, content, and related entities Research Question: Shows the question text, project affiliation, related findings, themes, and supporting quotes Status: Shows all entities assigned this status value, organized by entity type Priority: Shows all entities assigned this priority value, organized by entity type Other Entity Types: Shows observations and relationship information for other entity types
Status and Priority Information: All entity displays include status information when available via has_status relations Priority assignments are shown for tasks and other prioritized elements Valid status values include: planning, data_collection, analysis, writing, complete, scheduled, conducted, transcribed, coded, analyzed, emerging, developing, established, preliminary, draft, final, active, in_progress Valid priority values include: high, low
Sequential Process Relationships: Entity displays show preceding and following entities through precedes relations Process sequences are visualized to show workflow between research activities Research phases and activities display their position in the overall research process
Return information: Formatted markdown text with hierarchical structure Sections adapted to the specific entity type Related entities shown with their descriptions and connections Status and priority information prominently displayed Sequential relationships clearly indicated Error messages if the entity doesn't exist or can't be retrieved
You should: Specify the exact entity name for accurate retrieval Provide the entity type when possible for optimally formatted results Start with project entities to get a high-level overview of research Use participant context to understand individual perspectives Examine interview context to see coding applied to raw data Review code context to understand analytical categories Explore theme context to see patterns and theoretical constructs Use research question context to track progress toward answering key inquiries Examine memo context to review analytical insights Check status entities to see all research elements at the same stage Review priority entities to identify critical research tasks Explore sequential relationships to understand research process flow After retrieving context, follow up on specific entities of interest Use in conjunction with startsession to maintain session tracking Remember that this tool only retrieves existing information; use buildcontext to add new entities
|
endsession | A multi-stage tool for documenting qualitative research sessions, recording analysis progress, tracking coding activities, and creating a structured record of research evolution. When to use this tool: Concluding a qualitative research analysis session Documenting interview data collection activities Recording newly created analytical memos Tracking coding activities and code applications Documenting emerging themes and theoretical constructs Updating overall project status and progress Creating a structured record of research activities Establishing a formal conclusion to a focused research period Building a historical record of project development Documenting observations and insights from a research session Updating status values for research activities and entities Assigning or modifying priority levels for research tasks Establishing or modifying sequential relationships between research processes
Key features: Provides a structured, multi-stage workflow for research session documentation Records interview data collection in the knowledge graph Captures newly created analytical memos Tracks coding activities across data sources Documents emerging themes and their connections to codes Updates project status information Maintains session continuity with unique session IDs Supports revision of previous stages when needed Offers a comprehensive assembly stage that consolidates all session information Organizes qualitative research activity into a coherent narrative Manages status progression of research activities Tracks priority assignments for research tasks Documents sequential relationships between research processes
The endsession tool uses a sequential, multi-stage approach with typically 8 stages: Summary Stage: Records basic session information Interview Data Stage: Documents new interviews conducted Memos Stage: Records new analytical memos created Coding Activity Stage: Documents code applications and coding work Themes Stage: Records emerging themes and theoretical insights Status Updates Stage: Records changes to entity status values Project Status Stage: Updates the overall project status Assembly Stage: Consolidates all information and finalizes the session record
Parameters explained: sessionId: Required - Unique identifier for the research session
stage: Required - Current stage of the endsession workflow
Accepts: "summary", "interviewData", "memos", "codingActivity", "themes", "statusUpdates", "projectStatus", or "assembly" Each stage has specific data requirements and processing logic
stageNumber: Required - The sequence number of the current stage
totalStages: Required - Total number of stages planned for this workflow
analysis: Optional - Text analysis or observations for the current stage
stageData: Optional - Stage-specific structured data
nextStageNeeded: Required - Whether additional stages are needed after this one
isRevision: Optional - Whether this is revising a previous stage
revisesStage: Optional - If revising, which stage number is being revised
Status and Priority Management: The statusUpdates stage allows for batch updates to entity status values Valid status values include: planning, data_collection, analysis, writing, complete, scheduled, conducted, transcribed, coded, analyzed, emerging, developing, established, preliminary, draft, final, active, in_progress Priority assignments (high, low) can be modified in the projectStatus stage Status changes are tracked to maintain a history of research progression Priority changes help reallocate focus as research needs evolve
Sequential Process Management: The projectStatus stage allows for defining or modifying sequential relationships The precedes relation is used to establish logical ordering between research activities Sequential updates help maintain a coherent research workflow Process sequences can be visualized through the loadcontext tool
When the endsession workflow completes (assembly stage with nextStageNeeded: false), the tool: Records the session completion in persistent storage Creates a formatted summary of all session information Updates the status, priority, and sequential relationships for relevant entities Preserves the record of research activities for future reference
Return information: You should: Complete all stages in order for comprehensive session documentation Provide specific details in each stage for accurate research documentation Document interview data with participant identifiers and key notes Create descriptive titles for analytical memos Be specific about which codes were applied to which data items Connect emerging themes to their supporting codes Update status values to reflect progress in research activities Assign appropriate priorities to focus attention on critical tasks Define logical sequences between research processes with precedes relations Include relevant observations for project status updates If making a revision, specify which stage is being revised Only mark nextStageNeeded as false on the final assembly stage Review the final summary message to confirm all session details were recorded properly Use the unique session ID consistently across all stages
|
startsession | A comprehensive tool for initializing a new qualitative research session, providing structured information about ongoing research projects, participants, analytical elements, and recent research activities. When to use this tool: Beginning a new research analysis session Getting oriented to your current research state across multiple projects Planning which research elements to focus on in the current session Reviewing recent research activities and progress Identifying active research projects and their status Exploring available participants for analysis Reviewing your most frequently used codes Accessing recent analytical memos Establishing research context before diving into specific analysis tasks Re-engaging with your research after time away Prioritizing high-priority research tasks Tracking the status of various research activities Understanding sequential research processes
Key features: Generates a unique session identifier for tracking research activities Retrieves and displays recent research sessions with summaries Lists active research projects with status and phase information Provides a sample of research participants with demographic information Presents your most frequently used codes with reference counts Highlights recent analytical memos with type and summary information Formats information in an easily scannable format for quick orientation Integrates with the loadcontext tool for deeper exploration Maintains continuity between research sessions Tracks research session history for progress review Displays high-priority research tasks needing attention Shows status information for key research activities Presents sequential relationships between research processes
Parameters explained:
No parameters required - the tool automatically retrieves all relevant context. Return information: A unique session identifier Recent research sessions (up to 3) with: Date Project name Brief summary
Active research projects with: Project name Current status Research phase
Sample participants (up to 5) with: Participant name Demographic information Participation status
Top codes (up to 10) with: Code name Reference count Code group
Recent memos (up to 3) with: Memo name Creation date Memo type Brief summary
High-priority research tasks (up to 5) with: Task name Current status Associated project
Upcoming research activities (up to 3) with: Activity name Scheduled date Prerequisite activities Current status
Status and Priority Information: Research activities are displayed with their current status values High-priority tasks are prominently highlighted for attention Valid status values include: planning, data_collection, analysis, writing, complete, scheduled, conducted, transcribed, coded, analyzed, emerging, developing, established, preliminary, draft, final, active, in_progress Priority values (high, low) help indicate which tasks need immediate attention
Sequential Process Information: Upcoming activities show prerequisite tasks that must be completed first Research phases are presented in their logical sequence The precedes relation is used to determine activity ordering Sequential relationships help visualize the research workflow
Session Workflow: Start a research session with startsession Review the provided context to decide what to focus on Use loadcontext to retrieve detailed information about specific research elements Conduct your analysis, adding new elements with buildcontext as needed End the session with endsession to record your research progress
You should: Begin each focused research period with startsession to establish context Review recent sessions to maintain continuity in your research Identify active projects that require attention Note available participants for interview analysis Consider frequently used codes that may indicate important patterns Review recent memos to reconnect with your analytical thinking Prioritize high-priority tasks for immediate attention Check the status of research activities to maintain progress awareness Consider sequential relationships when planning your research activities Use the session ID when using other tools to maintain session tracking After completing a session, record your progress using endsession Establish a regular cadence of research sessions to maintain momentum Use the structured overview to make deliberate choices about where to focus your analytical effort
|
buildcontext | A versatile tool for constructing and enhancing the qualitative research knowledge graph by adding new research elements, relationships, and observations. When to use this tool: Creating new research entities (projects, participants, interviews, observations, codes, themes, memos, etc.) Establishing relationships between research elements (e.g., connecting participants to projects, codes to data segments) Adding observations, notes, or content to existing research entities Building the research corpus incrementally as data collection and analysis progress Organizing and structuring qualitative data within your research framework Documenting emerging themes, codes, and analytical insights during research Creating research questions and linking them to findings Building code hierarchies and thematic frameworks Setting status values for research activities and entities Assigning priorities to research tasks and activities Defining sequential relationships between research processes
Key features: Creates three distinct types of knowledge graph elements: entities, relations, and observations Supports specialized qualitative research entity types (projects, participants, interviews, observations, documents, codes, etc.) Validates entity and relation types against predefined standards for the qualitative research domain Handles batch creation of multiple entities or relations in a single operation Returns confirmation with details of created elements Ensures proper data typing and structure for the qualitative research knowledge graph Enables comprehensive documentation of the research process Supports status and priority assignment through entity-relation model Enables sequential relationships through precedes relation
Parameters explained: type: The type of creation operation to perform
Accepts: "entities", "relations", or "observations" Determines how the data parameter is interpreted
data: The content to add to the knowledge graph (structure varies by type):
For "entities": An array of objects, each containing: name: Unique identifier for the entity entityType: One of the valid entity types (project, participant, interview, observation, document, code, codeGroup, memo, theme, quote, literature, researchQuestion, finding, status, priority) observations: Array of strings containing notes or properties about the entity
For "relations": An array of objects, each containing: from: Name of the source entity to: Name of the target entity relationType: The type of relationship between entities (e.g., "participated_in", "codes", "has_status", "has_priority")
For "observations": Either a single object or an array of objects, each containing:
Valid entity types: project: Overall research study participant: Research subjects interview: Formal conversation with participants observation: Field notes from observational research document: External materials being analyzed code: Labels applied to data segments codeGroup: Categories or families of related codes memo: Researcher's analytical notes theme: Emergent patterns across data quote: Notable excerpts from data sources literature: Academic sources researchQuestion: Formal questions guiding the study finding: Results or conclusions status: Entity status values priority: Entity priority values
Valid relation types: participated_in: Links participants to interviews/observations codes: Shows which codes apply to which data contains: Hierarchical relationship supports: Data supporting a theme or finding contradicts: Data contradicting a theme or finding answers: Data addressing a research question cites: References to literature followed_by: Temporal sequence related_to: General connection reflects_on: Memo reflecting on data/code/theme compares: Comparative relationship has_status: Links entity to its status has_priority: Links entity to its priority precedes: Entity comes before another entity in sequence
Status information: Valid status values include: planning, data_collection, analysis, writing, complete, scheduled, conducted, transcribed, coded, analyzed, emerging, developing, established, preliminary, draft, final, active, in_progress Status is assigned through the has_status relation type
Priority information: Return information: Error handling: Validates entity types against the predefined list for qualitative research Validates relation types against acceptable standards Returns descriptive error messages for invalid inputs Gracefully handles type mismatches and formatting errors
You should: Use consistent naming conventions for entities to facilitate relationships and retrieval Begin by creating projects and participants before more specific research elements Add detailed observations to entities to enhance context and retrievability Create relationships to build a comprehensive network of interconnected research data Use has_status relations to track the progress of research activities Use has_priority relations to indicate important research elements Use the precedes relation to establish sequences in research processes Use observations to document the evolution of codes, themes, and analytical thinking Regularly update entity observations as your understanding evolves Build hierarchical structures using relations (e.g., codes within code groups, themes connecting multiple codes) Document the full research journey by adding memos tied to specific analytical moments Link quotes to codes, themes, and findings to maintain evidential chains
|
deletecontext | A precise tool for removing elements from the qualitative research knowledge graph, enabling researchers to maintain data accuracy and refine their analytical framework. When to use this tool: Removing incorrect or duplicate research entities Deleting erroneous relationships between research elements Clearing outdated observations from research entities Restructuring your research framework as analysis evolves Removing pilot or test data that shouldn't be included in final analysis Cleaning up the knowledge graph during research refinement phases Eliminating deprecated codes, themes, or concepts that no longer fit your analytical framework Removing sensitive information that should not be retained Reorganizing your analytical structure by removing and recreating elements Updating status assignments when research activities change state Modifying priority assignments as research focus shifts Restructuring sequential relationships between research processes
Key features: Provides targeted deletion capabilities for three distinct types of knowledge graph elements: entities, relations, and observations Maintains knowledge graph integrity during deletion operations Supports batch deletion of multiple items in a single operation Returns clear confirmation of deletion results Preserves the overall structure of the research knowledge graph while removing specific elements Performs validation to ensure deletion requests are properly formatted Handles status and priority relation management Supports modification of sequential process relationships
Parameters explained: type: The type of deletion operation to perform
Accepts: "entities", "relations", or "observations" Determines how the data parameter is interpreted
data: The elements to remove from the knowledge graph (structure varies by type):
For "entities": Array of entity names to delete For "relations": Array of relation objects, each containing: from: Name of the source entity to: Name of the target entity relationType: Type of relationship to remove (e.g., "participated_in", "codes", "has_status", "has_priority", "precedes")
For "observations": Array of objects, each containing:
Deletion behavior by type: Entities: Removes the specified entities and all their associated relations from the knowledge graph Relations: Removes only the specified relationships, leaving the connected entities intact Observations: Removes specific observations from entities while preserving the entities themselves
Status and Priority Management: When deleting status or priority entities, be aware of the impact on entities that reference them For changing an entity's status or priority, first delete the existing has_status or has_priority relation, then create a new one Consider the research workflow implications when removing status entities or relations Deletion of a status entity will remove all has_status relations pointing to it
Sequential Process Management: Removing precedes relations affects the logical flow of research processes Consider restructuring sequential relationships after deletion to maintain process continuity When reorganizing research phases, update all affected precedes relations
Safety considerations: Entity deletion is permanent and will also remove all relationships involving those entities Consider exporting or backing up your research knowledge graph before performing large-scale deletions For sensitive operations, consider removing specific observations rather than entire entities When removing codes or themes, consider the impact on your analytical framework Status changes should be carefully managed to maintain accurate research progress tracking Changes to sequential relationships may affect dependent research activities
Return information: You should: Be specific in your deletion requests to avoid unintended data loss Use relations deletion when you want to disconnect entities without removing them For observations, provide the exact indices to ensure only the intended content is removed When restructuring your analysis, consider how deletions will affect related elements Use deletecontext in conjunction with buildcontext to refine and evolve your research framework Regularly review your knowledge graph for elements that may need to be removed or updated Consider the cascading effects of entity deletion on your overall research structure Use observation deletion for minor corrections rather than removing entire entities When updating entity status, delete the old has_status relation before creating a new one Maintain logical consistency when modifying sequential process relationships
|
advancedcontext | A sophisticated query tool for exploring, analyzing, and retrieving complex information from the qualitative research knowledge graph. When to use this tool: Retrieving a comprehensive view of your entire research knowledge structure Searching for specific research entities across your qualitative data corpus Getting detailed information about particular research projects, participants, or analytical elements Exploring relationships between research components (codes, themes, quotes) Analyzing code frequencies and distributions across your data Retrieving interview or observation transcripts for analysis Accessing memo content for reflection on the research process Generating codebooks or analytical frameworks for documentation Finding connections between different aspects of your research Creating research reports or summaries from your data Exploring thematic structures and their evidentiary basis Identifying entities by status to track research progress Filtering tasks by priority to manage research workflow Analyzing sequential relationships between research processes
Key features: Offers specialized operations for querying different aspects of qualitative research data Retrieves complete or filtered views of the research knowledge graph Provides flexible search capabilities across all research entities Supports detailed exploration of specific entities by name Generates specialized views for projects, participants, codes, and themes Retrieves content and metadata for interviews, transcripts, and memos Creates codebooks and thematic frameworks for documentation Identifies related entities to explore connections within your research Returns consistently structured JSON responses for easy processing Facilitates depth and breadth exploration of qualitative data Supports status-based filtering of research entities Enables priority-based task management Provides sequential process analysis capabilities
Parameters explained: type: The type of query operation to perform
Accepts one of the specialized operations: "graph", "search", "nodes", "project", "participant", "codes", "themes", "transcript", "memo", "analysis", "codebook", "related", "status", "priority", "sequence" Determines how the params parameter is interpreted
params: Operation-specific parameters (structure varies by type):
For "graph": No parameters needed (retrieves the full research knowledge graph) For "search": Object containing: For "nodes": Object containing: For "project": Object containing: For "participant": Object containing: For "codes": Object containing: For "themes": Object containing: For "transcript": Object containing: For "memo": Object containing: For "analysis": Object containing: For "codebook": Object containing: For "related": Object containing: For "status": Object containing: For "priority": Object containing: For "sequence": Object containing:
Operation details: graph: Returns the complete research knowledge graph with all entities and relationships search: Performs text-based search across entity names and observations nodes: Retrieves detailed information about specific entities by name project: Returns comprehensive project information including participants, interviews, codes, and findings participant: Generates a participant profile with demographic information and associated data codes: Lists all codes, optionally filtered by project, with reference counts and descriptions themes: Returns all themes, optionally filtered by project, with associated codes and descriptions transcript: Retrieves interview transcript content for specific participant/interview combinations memo: Returns the full content of an analytical memo with metadata analysis: Collects all analysis artifacts (codes, themes, memos) for a specific project codebook: Generates a structured codebook for a project with code definitions and examples related: Identifies all entities directly connected to a specific entity status: Retrieves all entities with a specific status value priority: Retrieves all entities with a specific priority value sequence: Identifies sequential relationships for a specific entity showing preceding and following entities
Status and Priority Information: Status queries return entities organized by their current research stage Priority queries help identify critical research tasks and elements Status values include: planning, data_collection, analysis, writing, complete, scheduled, conducted, transcribed, coded, analyzed, emerging, developing, established, preliminary, draft, final, active, in_progress Priority values include: high, low
Sequential Process Information: Sequence queries identify entities that come before or after in a research process Sequential relationships help visualize the research workflow The sequence operation shows both incoming and outgoing precedes relations
Return information: You should: Start with broad queries ("graph", "search") to explore your research corpus Use specific entity queries ("nodes", "project", "participant") for detailed information Combine search and related queries to discover connections in your data Generate codebooks and project overviews for documentation and reporting Use transcript retrieval to access primary data when needed Explore thematic structures through themes and related entity queries Review memos to track your analytical process over time Filter code and theme queries by project for more focused results Use search with entity type filters to find specific types of research elements Use status queries to identify all entities at a particular research stage Use priority queries to focus on high-priority research tasks Use sequence queries to understand process flows in your research methodology
|