Model Context Protocol

Give your AI full access to your Help Scout inbox.

Every resolved conversation, your knowledge base, and your help center, searchable by meaning from Claude, Cursor, or any MCP client. Six tools, all read-only: your AI can find anything and touch nothing.

$
claude mcp add --transport http replyscout https://app.replyscout.com/mcp
Use cases

What you’ll actually ask it.

Connect it once and every AI tool you use gains your support history. These are first-day prompts, not a roadmap.

For support leads

“Summarize this customer’s history before my call with them.”

get_conversation loads the full thread plus every past conversation from that customer.

For engineers

“Have any customers hit this webhook timeout? How did we work around it?”

search_similar_tickets, from inside Cursor or Claude Code, while the bug is still on your screen.

For new teammates

“How do we usually phrase it when we decline a refund?”

Agent-side search over your team’s past replies. Institutional memory without interrupting anyone.

For docs writers

“What do customers actually ask about onboarding? Draft a help article that answers it.”

search_similar_tickets for the real questions, search_help_articles to check what’s already published.

For triage

“List unassigned open tickets tagged billing and flag anything about failed payments.”

list_conversations filters by status, assignee, and tag; get_conversation loads the ones that matter.

For anyone answering

“Find our policy on invoice reissues and what we told the last customer who asked.”

search_documentation plus search_similar_tickets in one pass: policy and precedent together.

Read-only by design

It can find anything. It can’t touch anything.

Ask anyone who runs a Help Scout MCP server which feature gets requested most. The answer is write access: let the AI reply, tag, close. The community servers that shipped it ended up burying customer-visible sends behind two separate opt-in flags, because nobody actually wants an assistant that is one confused tool call away from emailing a customer.

So this server has no write surface at all. Not disabled, just absent. There is no flag to flip and nothing to misconfigure:

  • No send
  • No edit
  • No tag changes
  • No close
  • No delete

That makes it safe to hand to anything: a model you’re still evaluating, an autonomous agent, an intern’s experiment. The worst thing that can happen is a read.

And when you do want AI-written replies, that’s ReplyScout itself: it drafts inside Help Scout, your agent reviews, and nothing ever auto-sends. Same retrieval layer, human hand on the send button.

Six tools, not sixty

Some MCP servers mirror the entire Help Scout REST API into a hundred tools, and your context window pays for every one of them on every request. These six cover the two jobs that matter: read the inbox, search it by meaning. All read-only. The search tools need an inbox ID, so call list_inboxes first.

search_similar_tickets
Semantic search across resolved conversations in an inbox. Matches both the customer message and your team’s reply, so "have we seen this before?" and "how did we phrase that?" both work. Narrow with type: customer or agent when you know which side you want.
search_documentation
Searches the knowledge base indexed for that inbox: internal policies, product details, runbooks. Returns passages with source URLs.
search_help_articles
Searches your public help center so answers stay consistent with what customers can already read. Returns article titles and shareable URLs.
get_conversation
Loads a full thread plus that customer’s history, with HTML email noise stripped. The context you need before answering, in one call.
list_conversations
Browses and filters an inbox by status, assignee, tag, or customer. For triage sweeps and reporting.
list_inboxes
Discovers the connected inboxes and their IDs. Call this first, since the search tools need an inbox ID.

Help Scout ships an MCP server. This one does retrieval.

Help Scout’s own MCP server went GA in July 2026, it’s free on every plan, and it’s a good piece of work: read-only access to live conversations and customer data, scoped to each teammate’s permissions. If you want your assistant to pull up a ticket, use it.

ReplyScout’s MCP server answers a harder question: have we solved this before, and what did we say? Its search tools run over the semantic indexes ReplyScout builds from your resolved conversations and your documentation. It finds the ticket that means the same thing, not the one that happens to share a keyword. The two servers compose, and most teams run both.

Help Scout’s official MCP

Live conversations, customers, and inbox analytics via the Help Scout API.

Per-user permission scoping. Free on every plan. Read-only.

Best for: pulling up and reporting on what’s in the inbox right now.

ReplyScout’s MCP

Semantic search over resolved tickets, your knowledge base, and your help center.

Matches customer questions and your team’s past replies. Read-only.

Best for: recalling precedent, policy, and phrasing before you answer anything.

Setup takes a minute

It’s a hosted remote server, so there is nothing to install: no npm package, no Docker container, no local process to keep alive. Streamable HTTP, MCP protocol 2025-06-18, one bearer token.

1. Create an API key

Generate a key in your ReplyScout account settings. Keys are stored as SHA-256 hashes and scoped to the inboxes on your account; rotating a key invalidates the previous one immediately.

2. Add the server to your client

Claude Code, in one command:

claude mcp add --transport http replyscout https://app.replyscout.com/mcp \
  --header "Authorization: Bearer rs_your_api_key"

Claude Desktop, Cursor, and other config-file clients:

{
  "mcpServers": {
    "replyscout": {
      "type": "http",
      "url": "https://app.replyscout.com/mcp",
      "headers": {
        "Authorization": "Bearer rs_your_api_key"
      }
    }
  }
}
3. Ask your first question

Try “Which Help Scout inboxes can you see?” That’s list_inboxes, and if it answers, you’re live. Then ask the question you’ve given up typing into Help Scout search.

Help Scout MCP questions

Give your AI tools your team's memory.

The MCP server is included with every ReplyScout plan, and the 7-day trial covers it. Connect an inbox, grab a key, ask your first question in five minutes.