Plain MCP
Read and manage Plain support threads, customers, tenants, broadcasts, help-center content, Sidekick sessions, and workspace settings through Plain's hosted MCP server.
80 actionsAPI key
What your bot can do in Plain MCP
Looks up
- GetbroadcastaudiencedetailsFetch a single broadcast audience by its ID, or null if no audience with that ID exists.
- GetbroadcastaudiencesFetch a paginated list of the workspace's broadcast audiences, newest first.
- GetbroadcastdetailsFetch a single broadcast by its ID, including its authored content and who it is targeted at.
- GetbroadcastsFetch a paginated list of the workspace's broadcasts, newest first.
- GetbroadcastsenddeliveriesFetch the individual recipients of one broadcast send — which channel got the message, which did not, and why.
- GetbroadcastsendsFetch the send history of one broadcast, newest first.
- GetcustomerdetailsFetch detailed information about a specific customer by their ID.
- GetcustomersFetch a paginated list of customers from Plain.
- GetcustomerthreadsFetch first 10 threads for a specific customer.
- GethelpcenterarticleFetch detailed information for a specific help-center article by ID.
Show 24 more
- GethelpcenterarticlebyslugFetch detailed information for a specific help-center article by slug.
- GethelpcenterarticlegroupsFetch a paginated list of article groups for a specific help center.
- GethelpcenterarticlesFetch a paginated list of articles for a specific help center.
- GethelpcentersFetch a paginated list of help centers.
- GetlabelsFetch a paginated list of label types from Plain.
- GetmyassignedthreadsFetch first 10 threads assigned to a specific user in Plain.
- GetmyuserGet the currently authenticated user's details.
- GetmyworkspaceGet the currently authenticated user's workspace details.
- GetsidekicksessionPoll a Sidekick session.
- GetsnippetFetch a single snippet by ID, including soft-deleted snippets (where isDeleted is true).
- GetsnippetsFetch a paginated list of snippets from the workspace.
- GettenantdetailsFetch detailed information about a specific tenant by their ID.
- GettenantsFetch a paginated list of tenants from Plain.
- GetthreaddetailsFetch complete details for a specific thread including first 50 timeline entries.
- GetthreadfieldschemasFetch a paginated list of thread field schemas from Plain.
- GetthreadknowledgesourcecitationsFetch the knowledge sources cited by AI agent replies on a thread.
- GetthreadsFetch threads with flexible filtering options.
- GetuserbyemailLook up a Plain user by their email address.
- ListsidekicksessionsList Sidekick sessions in the workspace, most recent activity first.
- SearchbroadcastsSearch broadcasts by name.
- SearchcustomersSearch for customers by name, email, short name, or external ID.
- SearchtenantsSearch for tenants by name or external ID.
- SearchthreadlinkcandidatesSearch a connected issue tracker for external entities that can be linked to a thread via createThreadLink.
- SearchthreadsSearch threads by text content in title, description, or messages.
Takes action
- AddgeneratedreplyAdd an AI-generated reply suggestion to a thread.
- AddlabelsAdd labels to a thread by label type IDs.
- ArchivelabeltypeArchive a label type to hide it from the active label list.
- AssignthreadAssign a thread to a user or machine user.
- BulkupsertthreadfieldsBulk upsert (create or update) multiple thread field values in a single operation.
- ChangethreadpriorityChange the priority of a thread.
- CreatebroadcastCreate a new broadcast.
- CreatebroadcastaudienceCreate a reusable broadcast audience.
- CreatelabeltypeCreate a new label type for organizing threads.
- CreatenoteCreate an internal note on a thread.
Show 36 more
- CreatesnippetCreate a new snippet (reusable reply template) in the workspace.
- CreatethreadCreate a new thread for a customer.
- CreatethreadfieldschemaCreate a new thread field schema to capture structured data on threads.
- CreatethreadlinkLink a thread to an external entity (e.g.
- CreateworkspaceslackintegrationfromauthConnect workspace Slack notifications using a Slack connection the workspace already has.
- DeletebroadcastSoft-delete a broadcast.
- DeletebroadcastaudienceSoft-delete a broadcast audience.
- DeletethreadfieldschemaDelete a thread field schema from the workspace.
- DeletethreadlinkRemove a link between a thread and an external entity.
- GetattachmentdownloadurlGenerate a short-lived download URL for an attachment on a thread.
- MarkcustomerasspamFlag a customer as spam.
- MarkthreadasdoneMark a thread as done (resolved).
- MarkthreadastodoMark a thread as todo (reopen or set as active).
- MergethreadMerge one Plain thread into another (a MERGED_INTO native thread link).
- MovelabeltypeMove a label type to a different position in the label hierarchy.
- RemovelabelsRemove labels from a thread by label IDs.
- ReorderthreadfieldschemasReorder multiple thread field schemas in a single operation.
- ReplytothreadReply to the last message in a thread.
- ResolvesidekickapprovalApprove or deny a Sidekick tool-call approval request.
- SendsidekickmessageSend a follow-up message into an existing Sidekick session.
- SendtestbroadcastSend a test copy of a broadcast to Slack channels you name, so you can see what recipients will get before the real audience does.
- SnoozethreadSnooze a thread for a specified duration.
- StartsidekicksessionStart a new Sidekick session and return the handle used by every other Sidekick tool.
- UnarchivelabeltypeUnarchive a previously archived label type to make it available again.
- UnassignthreadUnassign a thread, removing the current assignee.
- UnmarkcustomerasspamClear the spam flag from a customer, restoring their threads to the inbox and metrics.
- UpdatebroadcastUpdate one or more fields of an existing broadcast.
- UpdatebroadcastaudienceUpdate a broadcast audience's name, filters, or both.
- UpdatelabeltypeUpdate an existing label type's properties.
- UpdatethreadfieldschemaUpdate an existing thread field schema's properties.
- UpdatethreadtitleUpdate the title (subject line) of an existing thread.
- UpsertcustomerCreate or update a customer.
- UpserthelpcenterarticleCreate or update a help-center article.
- UpserttenantCreate or update a tenant.
- UpserttenantfieldCreate or update a tenant field.
- UpsertthreadfieldUpsert (create or update) a thread field value on a thread.