Search Docs articles
Docs articles matching a search, across your Docs sites.
MCP tool help_scout_read → search_docs_articles
read
Searches the articles of your Docs sites the way the Docs results in Help Scout search do and returns each hit with its collection, status and whether an unpublished draft exists. Published and not published articles both appear, so you can find a draft that someone else is editing.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Search text. |
| status enum | enum | all, published or notpublished. Default: all. |
| limit integer | integer | 1 to 50. Default: 20. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "help_scout_read",
"arguments": {
"operation": "search_docs_articles",
"arguments": {
"query": "query"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"query": "Reports",
"articles": [
{
"article_id": "6628f1a2b5d30",
"name": "Export conversation data",
"collection": "Using Help Scout",
"status": "published",
"has_draft": false,
"url": "https://docs.example.com/article/12-export-conversation-data"
},
{
"article_id": "6628f1a2b5d41",
"name": "Reports API overview",
"collection": "Developers",
"status": "published",
"has_draft": true,
"url": "https://docs.example.com/article/19-reports-api-overview"
}
]
},
"isError": false
}