Qualitative Researcher MCP Server

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:

1. entityName: Required - The name of the entity to retrieve context for

• Example: "Health Behavior Study", "Participant_P001", "Interview_20230315"

2. 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"

3. sessionId: Optional - The current session identifier

• Typically provided by startsession

• Used for tracking entity views within the session

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