Skip to content
SupportHQ
MCP server

Your support inbox, inside your AI tools.

SupportHQ has an MCP server. Connect Claude Code, Cursor or VS Code to your company, then ask who is waiting for a human, reply to them, or fix a knowledge base entry. You do not need to open the dashboard.

Connect in 2 minutes Start free trial
  • Works with any remote MCP client
  • 18 tools for bots, conversations and knowledge
  • Read only or read and write keys, one company each
  • Does not use your message limits
An AI assistant on a laptop connected by a cable to a SupportHQ conversation inbox and knowledge base

What you can ask

Ask in plain language. Your AI does the lookups.

Your AI tool reads the tool list, picks the right calls, and answers from your real support data.

You ask

"Which visitors on the Acme bot are waiting for a human right now?"

You ask

"Summarize the last ten conversations labeled "billing"."

You ask

"Reply to Sam that the refund is on its way, and label it "refund"."

You ask

"Change the refund window in our knowledge base from 14 to 30 days."
An AI assistant sorting chat conversations into labeled stacks, with one marked as needing a person

Conversations

Triage and reply from your editor

Ask for every visitor still waiting on a human, or every conversation with a label. Your AI reads the full thread, oldest message first, with the contact and handoff state. Then it drafts a reply, and sends it when you say so, on the visitor's own channel.

  • Filter by "waiting for a human" or "a human replied"
  • Filter by label, or find unlabeled conversations
  • Reply as a human agent on website chat, Telegram or Discord
  • Label, pin, or turn the bot off for one conversation
A long document scroll with a magnifying glass highlighting one passage and bookmarks marking positions

Knowledge base

Read and edit long entries, one part at a time

A knowledge base entry can be far longer than one AI response can hold. SupportHQ sends the start of an entry and tells your AI how to read the rest. Your AI can also search the entry, jump straight to the passage it needs, and change only that passage.

  • Text, uploaded files, scraped web pages and saved conversations
  • Reads in parts that end at a line break, never mid-sentence
  • Edits send only the changed text, so entry length does not matter
  • An edit is refused if someone changed the entry since your AI read it

Tools

Every tool the server offers

Your AI tool sees this list when it connects and chooses tools by itself. You never call them by name.

Bots and plan

list_projects
Lists the bots in your company, with the channels each one answers on.
get_project
Shows one bot: model, channels, human handoff setting and knowledge base counts. Never includes channel secrets.
get_usage
Shows your plan and your usage over the last 30 days against each limit.

Conversations

list_conversations
Lists conversations, newest activity first. Filter by handoff state (for example, waiting for a human) or by label.
get_conversation
Shows one conversation: the contact, labels, handoff state and the latest messages in order.
list_messages
Pages back through a long conversation.
list_labels
Lists the labels a bot uses for its conversations.
reply_to_conversation Read and write key
Sends a reply to the visitor as a human agent, on their own channel: website chat, Telegram or Discord.
update_conversation Read and write key
Sets labels, pins the conversation, or turns the bot off or on for it.

Knowledge base

list_knowledge_entries
Lists text, file, web page and conversation entries. Filter by type or status, or search by title and URL.
get_knowledge_entry
Shows one entry: its details, what can be edited, and the start of its content.
read_knowledge_entry
Reads a long entry in parts, or finds text in it and returns each match with its position.
list_web_sources
Lists the websites added to a bot, with how many pages are scraped, queued or failed.
add_knowledge_text Read and write key
Adds a new text entry for the bot to answer from.
update_knowledge_entry Read and write key
Renames an entry, or replaces the content of a short one.
edit_knowledge_entry Read and write key
Changes only part of an entry, of any length, with find-and-replace edits. Nothing is saved if one edit does not match.
refresh_knowledge_entry Read and write key
Fetches a web page entry again from its URL.
delete_knowledge_entry Read and write key
Removes an entry from the knowledge base.

Setup

Connect in three steps

  1. 1

    Create an API key

    In the SupportHQ dashboard, open Settings, then AI connections, and select Create key. Choose read only, or read and write if your AI should reply and edit. Copy the key: it is shown only once.

  2. 2

    Add the server to your AI tool

    Give your tool the server URL https://api.supporthq.app/mcp and send the key in the Authorization header. The snippets on this page are ready to paste.

  3. 3

    Ask a question

    Ask in plain language, for example "who is waiting for a human?". Your AI tool picks the right SupportHQ tools and shows you what it found.

Server URL

https://api.supporthq.app/mcp
Create an API key

Claude Code

Run this in a terminal.

claude mcp add --transport http support-hq https://api.supporthq.app/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Add this to ~/.cursor/mcp.json.

{
  "mcpServers": {
    "support-hq": {
      "url": "https://api.supporthq.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

Add this to .vscode/mcp.json, or run "MCP: Add Server" from the command palette.

{
  "servers": {
    "support-hq": {
      "type": "http",
      "url": "https://api.supporthq.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your key. The dashboard shows these snippets with your key filled in, right after you create it.

Security

Access you control

The server gives your AI tool the same view you have in the dashboard, and never more.

One company per key

A key works for one company only. Your AI tool cannot see another company you belong to.

Your role applies on every request

SupportHQ checks your current role each time. If you leave the company or your role changes, the key follows at once.

You choose what a key can do

A read only key can look but not change anything. Only owners and admins can create keys that reply and edit.

Replies wait for your go-ahead

The reply tool tells your AI to show you the exact text and ask before it sends. Clients such as Claude Code also ask before each tool call unless you allow it.

Keys are stored as hashes

SupportHQ keeps a hash of each key, never the key itself. Revoke a key at any time from the dashboard.

Every call is logged

Each tool call is recorded with who made it and when, without storing the conversation text it returned.

Visitor text is marked as data

Anyone can write into a chat widget. Results that carry visitor messages tell the AI to treat them as data, not as instructions.

FAQ

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI tools such as Claude, Cursor and VS Code use data and actions from other services. A service publishes an MCP server, and any MCP client can connect to it.

Which AI tools can connect today?

Any MCP client that supports remote servers over HTTP with a custom Authorization header. This includes Claude Code, Cursor, VS Code and Windsurf. Claude.ai and ChatGPT connectors need OAuth sign-in, which is coming next.

Can my AI tool reply to customers?

Yes, with a read and write key. The reply goes into the same conversation, on the visitor's own channel, exactly as if a teammate sent it from the inbox. A pending handoff is marked as answered.

Does using MCP count against my message limits?

No. Reading and human replies do not count toward your plan's conversation or message limits. Knowledge base content you add counts toward your storage, the same as in the dashboard.

Where does my data go?

Tool results go to the AI tool you connect, and that tool's data policy applies to them. SupportHQ never returns channel secrets such as bot tokens.

How do I stop access?

Revoke the key in Settings, then AI connections. The AI tool loses access on its next request.

Related solutions