Dovetail

Retrieve a single channel data point by its ID, including its full text content, sentiment, summary, source URL, metadata, and the themes it has been classified under. Use this after discovering a data point ID via list_channel_data or search_workspace to inspect a specific piece of customer feedback in detail. Dovetail URL: matches /channels/<channel_id>/data/<id> and the themed variant /channels/<channel_id>/themes/<theme_id>/data/<id> — extract the datum ID (the final segment after /data/).

get_channel_datum

Retrieve a single contact by its unique identifier. Contacts represent people in the contacts database — interview participants, customers, or research subjects — and may carry custom field data (e.g. company name, Salesforce ID). Use this when you have a contact ID referenced from another resource and need to resolve it to a name, email, or specific custom field value. Dovetail URL: matches /contacts/<id> — extract the contact ID from the path segment after /contacts/.

get_contact

Export and retrieve the complete content of a research data entry (such as interview transcripts, survey responses, usability test notes, or field study observations) in markdown format. This tool provides access to the raw or processed content of primary research data, making it readable and analyzable. Use this when you need to review the actual content of customer feedback, analyze specific responses or quotes, or extract detailed information from research sessions. The markdown format ensures the content is well-structured and easy to process for analysis. The response includes a content_pagination field; if the content you received is shorter than its returned_chars value or ends mid-sentence, your client truncated it — call again with offset set to next_offset (and optionally max_chars) to page through the rest. Dovetail URL: matches /data/<slug>-<id> — extract the data ID (the base62 or UUID portion after the last dash in the slug).

get_data_content

Retrieve detailed metadata for a single doc by its unique ID, including title, custom fields, project association, folder, attached files, and cover image. The response does not include the doc's text content — use get_doc_content to read the rich-text body. Use this when you already know a doc ID and need its full metadata before deciding whether to fetch the content. Dovetail URL: matches /docs/<slug>-<id> (and /docs/<id> when the doc has no title slug) — extract the doc ID (the base62 or UUID portion after the last dash in the slug, or the full segment when there is no dash).

get_doc

Retrieve a single comment on a doc by its unique identifier. Returns the comment's body, author, timestamps, and thread status. Use this when you already know both the doc ID and the comment ID — for example to inspect a specific comment referenced from another tool's output. Dovetail URL: matches /docs/<slug>-<id>#c=<comment_id> — extract the doc ID from the path (the base62 or UUID portion after the last dash in the slug, or the full segment when there is no dash) and the comment ID from the `c=` hash fragment.

get_doc_comment

Export and retrieve the complete content of a Dovetail doc in markdown format. Docs are rich-text research deliverables; this tool returns the full document body including headings, lists, embedded references, and other formatting. Use this whenever a user asks you to read, summarise, quote, or analyse a Dovetail doc by URL or ID. Pair with list_docs or get_doc to discover the right doc first. The response includes a content_pagination field; if the content you received is shorter than its returned_chars value or ends mid-sentence, your client truncated it — call again with offset set to next_offset (and optionally max_chars) to page through the rest. Dovetail URL: matches /docs/<slug>-<id> (and /docs/<id> when the doc has no title slug) — extract the doc ID (the base62 or UUID portion after the last dash in the slug, or the full segment when there is no dash). Prefer this tool over get_doc when the user asks to read, summarise, or quote the doc's contents.

get_doc_content

Browse and discover all projects in your Dovetail workspace. Projects are containers that organize qualitative research — each one holds data entries, docs, highlights, tags, and insights for a specific research initiative (e.g. an onboarding study or a churn investigation). Use this as the starting point for project discovery: resolve a project by title to its ID, then drill in via tools like list_project_data, list_docs, get_project_highlights, or list_tags. Each entry returns id, title, author, folder location, creation date, and deletion status. Pass `folder_id` to scope to a specific folder, or `title` to narrow to projects whose title contains the given substring (case-insensitive). Results are paginated. Dovetail URL: matches /projects and /browse.

get_dovetail_projects

Retrieve a single custom field definition by its unique identifier, including its label, type (TEXT, NUMBER, SINGLE_SELECT, etc.), options, rank, and the project it belongs to. Use this after discovering a field ID via list_fields when you need the full definition — for example to interpret field values returned on data or doc entries.

get_field

Retrieve metadata for a single file attachment by its unique identifier. Files are uploaded assets (images, documents, audio, video) embedded in docs, data entries, or insights. Returns the file's name, MIME type, size in bytes, processing status (pending, completed, failed), author, and creation date. Use this to check the processing status of an uploaded file, or to inspect a file referenced from a doc or data entry. To download the file's content, use download_file.

get_file

Retrieve a single folder by its unique identifier, including its title, parent folder, creation date, and a list of immediate child folder IDs. Use this to inspect a folder's position in the workspace hierarchy or to discover its direct subfolders before listing the contents of one of them. Dovetail URL: matches /folders/<id> and its section variants /folders/<id>/projects, /folders/<id>/docs, /folders/<id>/channels, /folders/<id>/dashboards, /folders/<id>/agents — extract the folder ID from the path segment immediately after /folders/.

get_folder

List all items contained directly within a specific folder — projects, docs, channels, dashboards, agents, and child folders. Use this to browse a folder's contents in a file-explorer-style navigation flow. Each item includes its type, title, creation date, and author. Results are paginated and sortable by creation date or title. Dovetail URL: matches /folders/<id> and its section variants /folders/<id>/projects, /folders/<id>/docs, /folders/<id>/channels, /folders/<id>/dashboards, /folders/<id>/agents — extract the folder ID from the path segment immediately after /folders/. Prefer this tool over get_folder when the user wants to know what's inside the folder rather than the folder's own metadata.

get_folder_contents

Retrieve a single highlight by its unique identifier, including its text content, associated data entry, tags, and (for transcript highlights) start/end timestamps. Highlights are selected passages of text or time ranges in audio/video transcripts that have been marked as significant during qualitative analysis. Use this when you already know a highlight ID — for example one returned by get_project_highlights or search_workspace — and need its full detail.

get_highlight

This tool is deprecated - use get_doc_content instead. Export and retrieve the complete content of a Dovetail insight (also called a 'doc' in the Dovetail UI) in markdown format. In Dovetail, insights and docs are the same entity — /insights/<slug>-<id> and /docs/<slug>-<id> URLs both refer to insights and are both handled by this tool. Use this whenever a user asks you to read, summarise, quote, analyse, or 'pull from' a Dovetail doc or insight by URL or ID. Returns the full text body including structure, findings, recommendations, and formatting. The markdown format preserves formatting and makes content easily readable and processable. The response includes a content_pagination field; if the content you received is shorter than its returned_chars value or ends mid-sentence, your client truncated it — call again with offset set to next_offset (and optionally max_chars) to page through the rest. Dovetail URL: matches /insights/<slug>-<id> AND /docs/<slug>-<id> — extract the ID (the base62 or UUID portion after the last dash in the slug).

get_insight_content

Retrieve metadata for a single Dovetail project by its unique identifier, including title, author, creation date, and folder location. Projects are containers that organize qualitative research — they hold data entries, docs, highlights, tags, and insights. Use this after discovering a project via get_dovetail_projects or search_workspace when you need its full metadata. Dovetail URL: matches /projects/<id> — extract the project ID from the path segment after /projects/.

get_project

Retrieve detailed metadata and information about a specific research data entry by its unique ID. Research data entries represent individual pieces of customer feedback such as interview sessions, survey responses, usability test results, or observation notes. This tool provides comprehensive details including participant information, data type, collection date, tags, status, and associated metadata. Use this when you have a specific data ID and need to understand its context, source, or characteristics before analyzing its content. Dovetail URL: matches /data/<slug>-<id> — extract the data ID (the base62 or UUID portion after the last dash in the slug).

get_project_data

Retrieve customer feedback highlights and key quotes from a specific research project. Highlights are the most important findings, quotes, and observations extracted from customer interviews, surveys, usability tests, and other research data. Use this tool when you need to understand what customers said about specific topics, gather supporting evidence for insights, or analyze sentiment and themes within a project. Each highlight includes the original source, tags, and context. Supports pagination for large datasets. Dovetail URL: matches /projects/<project_id> and /projects/<project_id>/highlights — extract the project ID from the URL path.

get_project_highlights

This tool is deprecated - use get_doc instead. Retrieve detailed metadata and information about a specific insight (also called a 'doc' in the Dovetail UI) by its unique ID. In Dovetail, insights and docs are the same entity — /insights/<slug>-<id> and /docs/<slug>-<id> URLs both refer to insights and are both handled by this tool. Insights/docs are structured research findings that synthesize patterns, themes, and conclusions from customer data. They typically include recommendations, supporting evidence, and impact assessments. This tool provides comprehensive details including metadata, status, and associated data sources. Use this when you have a specific insight or doc ID and need to understand its context, source, or characteristics before analyzing its content. Dovetail URL: matches /insights/<slug>-<id> AND /docs/<slug>-<id> — extract the ID (the base62 or UUID portion after the last dash in the slug).

get_project_insight

Retrieve a single tag by its unique identifier, including its title, the project it belongs to, and its creation date. Use this when you already know a tag ID — for example one referenced from a highlight returned by get_project_highlights — and need to resolve it to a human-readable label.

get_tag

Retrieve a single workspace member's profile by their unique identifier, including name, email, job title, role (CONTRIBUTOR, MANAGER, or VIEWER), and whether they are a workspace admin. Use this to resolve user IDs returned by other tools — for example to attribute a doc, insight, or highlight to its author.

get_user

List the raw data points (e.g. app reviews, NPS responses, support tickets) that flow into a specific channel. Use this after identifying a channel via list_channels or get_channel to inspect the underlying customer feedback the channel is analyzing. Each data point includes its source timestamp, text content, sentiment, summary, source URL, and the themes it has been classified under. Pass `source_timestamp_from` and/or `source_timestamp_to` (ISO 8601 datetimes, inclusive bounds) to scope results to a time window — e.g. set both to query a fixed range, or one to bound an open-ended range. Results are paginated and sorted by source_timestamp descending by default. Dovetail URL: matches /channels/<channel_id>/data — extract the channel ID from the URL path.

list_channel_data

Retrieve all themes for a channel. Themes are AI-generated clusters of data points that share a common subject within a topic. Each theme has a `title` (a short label summarising the cluster), an optional `summary` (a longer AI-generated description of what data points in the theme share in common), and a `datum_count` (the number of data points currently classified into the theme). This tool provides metadata about the themes in the channel, including their title, summary, and datum count. Dovetail URL: matches /channels/<channel_id>/themes — extract the channel ID from the URL path.

list_channel_themes

Browse and discover all channels in your Dovetail workspace. Channels are automated analysis pipelines that process high-volume customer feedback such as app reviews, NPS responses, support tickets, product reviews, and churn reasons into structured insights. Each channel entry includes metadata like title, creation date, and folder location. Pass `folder_id` to scope results to channels inside a specific folder, or omit it to list channels across the whole workspace. Use this tool to find channels before drilling into a specific channel's details and topics with get_channel. Supports pagination for workspaces with many channels. Dovetail URL: matches /channels.

list_channels

Browse the contacts database in your Dovetail workspace. Contacts are people involved in research — typically interview participants, customers, or survey respondents — and may carry custom field data such as company, role, or external identifiers (e.g. a Salesforce ID). Use this to discover contact IDs for cross-referencing participants across data entries, look up a participant by name, or list all known participants. Pass `name` to narrow results to contacts whose name contains the given substring (case-insensitive), or omit it to list everyone. Results are paginated.

list_contacts

Retrieve all comments on a specific doc, returned in chronological order. Comments capture discussion threads on docs — feedback, questions, and follow-ups posted by collaborators. Use this after locating a doc via list_docs, get_doc, or search_workspace to read its conversation history. Only published comments are included; results are paginated. Dovetail URL: matches /docs/<slug>-<id> (and /docs/<id> when the doc has no title slug) — extract the doc ID (the base62 or UUID portion after the last dash in the slug, or the full segment when there is no dash). Use this when the user references a doc and is asking about its comments, conversation, or discussion thread.

list_doc_comments

Browse and discover all docs in your Dovetail workspace. Docs are rich-text research deliverables — reports, write-ups, and shareable findings — that synthesize evidence from data entries, highlights, and other sources. The response contains metadata only (titles, folders, creation dates); use get_doc_content to read the actual document body. Pass project_id to scope to a single project, or omit it to list docs across the whole workspace.

list_docs

Retrieve all custom fields defined on a project. Fields are typed metadata slots attached to data entries and docs — for example a 'Company Name' text field on customer interviews, or an 'NPS Score' number field. Use this to discover what fields are available before reading or filtering on field values. Requires project_id and field_set_type ('data' or 'doc'); results are paginated and sorted by rank by default.

list_fields

Browse all folders in your Dovetail workspace. Folders organize projects, docs, channels, dashboards, agents, and other folders into a hierarchical structure similar to a file system. Pass `parent_folder_id` to enumerate children of a specific folder (note: listing only root-level folders via this filter is not available through MCP — use get_folder_contents on a known root folder, or omit the filter to list folders across the workspace). Pass `title` to narrow results to folders whose title contains the given substring (case-insensitive). Results are paginated.

list_folders

Retrieve all docs authored by or assigned to a specific user. Use this when you have a user ID (e.g. from get_user or list_users) and want to enumerate the docs they own. The response is metadata only — use get_doc_content to read each doc's body. Supports the same filtering, sorting, and pagination as list_docs.

list_personal_docs

Browse and discover all research data entries within a specific project to understand the scope and variety of customer feedback collected. This includes interviews, surveys, usability tests, field studies, and other primary research data. The tool returns metadata for each data entry including titles, types, collection dates, participant details, and status information. Essential for understanding what customer data is available in a project, planning analysis workflows, or identifying specific data sources to investigate further. Pass `title` to narrow to entries whose title contains the given substring (case-insensitive). Pass `created_at_from` and/or `created_at_to` (ISO 8601 datetimes, inclusive bounds) to scope results to a creation-date window. Supports pagination for projects with extensive research data. Dovetail URL: matches /projects/<project_id>/notes — extract the project ID from the URL path.

list_project_data

This tool is deprecated - use list_docs instead. Discover and browse all research insights within a specific project to understand the key findings and conclusions drawn from customer research. This tool provides an overview of all insights including their titles, descriptions, status, creation dates, and authors. Use this to get an understanding of what research conclusions have been documented, identify relevant insights for further investigation, or assess the scope of analysis completed within a project. Essential for project overviews and insight discovery workflows. Supports pagination for projects with many insights. Dovetail URL: matches /projects/<project_id>/insights — extract the project ID from the URL path.

list_project_insights

List all project templates available in your Dovetail workspace. Templates are reusable blueprints that define a project's fields, views, tags, and structural layout. Use this to discover template IDs that can pre-populate a new project with a standard research setup. Results are paginated.

list_project_templates

Browse and discover tags in your Dovetail workspace, scoped to a single project via the project_id filter. Tags are project-scoped labels applied to highlights during qualitative analysis — for example "Usability Issue", "Feature Request", or "Positive Feedback". Use this to enumerate the categorisation scheme of a project (which themes researchers track), or to resolve a tag's name to its ID before referencing it elsewhere. Each tag belongs to a single project. Results are paginated.

list_tags

List all members of your Dovetail workspace, including their name, email, job title, role, and admin status. Use this to discover user IDs — for example to enumerate docs authored by a specific user via list_personal_docs — or to display a directory of teammates. Pass `name` and/or `email` to narrow results to users whose name or email contains the given substring (case-insensitive); omit both to list everyone. Results are paginated.

list_users

Perform powerful text-based search across all content types in your Dovetail workspace to quickly find relevant customer feedback, research findings, and insights. This universal search tool can locate specific quotes, topics, themes, or concepts within highlights from customer interviews, research insights and conclusions, data entries like survey responses, organized content channels, tagged content, thematic analysis results, projects, and folders. Use this tool when you need to find all mentions of a specific topic, product feature, user behavior, or research question across your entire research repository — or to look up a project or folder by name to obtain its ID. Ideal for cross-project analysis, trend identification, and comprehensive research discovery. You can filter results by content type, scope results to specific projects or folders, restrict to a date range with `date_from`/`date_to` (and optionally `date_field` to switch between creation and last-updated dates), and use pagination to explore large result sets. To search within a folder or project, first call this tool with `types: ["FOLDER"]` or `types: ["PROJECT"]` to find the ID by name, then call again with `location_ids` set to that ID. Folder IDs include all nested sub-folders and their projects. The query can be omitted (or set to an empty string) to list all items of the chosen types. Dovetail URL: matches /search and /explore — if the URL has a #q=<query> hash, extract the query text.

search_workspace