MCP-first

Run HelpBird from your AI assistant.

HelpBird has a built-in MCP server. Connect Claude, ChatGPT, Claude Code, Cursor, VS Code or any MCP client once, and it can answer your customers, keep the help center current and set up the chat for you, with a preview before anything that matters.

MCP server URL
https://helpbird.app/mcp
  • Claude
  • ChatGPT
  • Claude Code
  • Cursor
  • VS Code
  • Any MCP client
What your agent can do

Everything you do in the panel, in 77 tools.

27 read and 50 make changes, each labelled so your client knows which is which. Anything without a tool of its own is reachable through the panel API tools.

reads makes a change

Start and set up

8 tools

What needs attention now, the install snippet and checks, and help from the HelpBird team.

  • What needs attention
  • Account overview
  • Install snippet
  • Check the install
  • Re-add the widget to the Shopify store
  • Skip a setup step
  • Owner profile
  • Contact HelpBird support

Inbox

24 tools

Read and answer conversations, assign, tag, snooze, merge and close them.

  • List conversations
  • Search conversations
  • Read a conversation
  • Mark as read
  • Reply to a customer
  • Send a file to a customer
  • Draft with AI
  • Add an internal note
  • Close or reopen
  • Close, reopen or snooze many
  • Merge two conversations
  • Assign a conversation
  • Set priority
  • Snooze a conversation
  • Tag a conversation
  • List conversation tags
  • Delete a tag
  • Block or unblock a conversation
  • List blocked conversations
  • List saved inbox views
  • Save an inbox view
  • Delete an inbox view
  • List the owner's mentions
  • Mark mentions read

Contacts and saved replies

6 tools

Who your customers are, and the answers your team reuses.

  • List contacts
  • Read a contact
  • Update a conversation's contact
  • List saved replies
  • Create a saved reply
  • Delete a saved reply

Help center

6 tools

Articles and categories, plus what visitors searched for and didn't find.

  • List help-center articles
  • Read a help-center article
  • Write a help-center article
  • Delete a help-center article
  • Add or rename a help-center category
  • Delete a help-center category

Automations and campaigns

9 tools

Rules that tag, assign or reply on their own, and messages to a segment of contacts.

  • List automation rules
  • Create or change an automation rule
  • Turn a rule on or off
  • Delete an automation rule
  • Reorder automation rules
  • List campaigns
  • Draft a campaign
  • Send a campaign
  • Delete a campaign

Widget and integrations

10 tools

Every setting of the chat: greeting, hours, AI auto-reply, colors, alerts, webhooks, verified identity.

  • Read widget settings
  • Change widget settings
  • List color themes
  • Set the widget colors
  • Delete a custom theme
  • List webhooks
  • Add or change a webhook
  • Delete a webhook
  • Read the identity secret
  • Rotate the identity secret

Team

6 tools

Teammates, their logins and who's available.

  • List the team
  • Set the owner's availability
  • Add a teammate
  • Change a teammate
  • Remove a teammate
  • Teammate login

Analytics and plan

4 tools

Support stats, the plan and invoices. Plan changes come back as a link you open; nothing is paid from the agent.

  • Support stats
  • Plan and billing
  • Get the link to change the plan
  • Cancel the plan

Everything else

4 tools

The panel's JSON API, one tool per kind of operation, for anything without a tool of its own.

  • Read from the HelpBird panel API
  • Create through the HelpBird panel API
  • Update through the HelpBird panel API
  • Delete through the HelpBird panel API
Connect in a minute

Pick your assistant.

Every client signs in the same way: a HelpBird page opens, you sign in and click Allow. Nothing to register with Anthropic or OpenAI, no key to copy.

Claude

claude.ai, Claude Desktop and the Claude mobile apps

  1. 1Open Settings → Connectors and click Add custom connector.
  2. 2Name it HelpBird and paste the server URL: https://helpbird.app/mcp
  3. 3Click Connect. A HelpBird page opens: sign in (or create your account) and click Allow.
  4. 4Turn HelpBird on from the tools menu of a chat. A connector added on claude.ai also works in the desktop and mobile apps.

ChatGPT

chatgpt.com and the ChatGPT apps

  1. 1Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
  2. 2Back in Apps & Connectors, click Create.
  3. 3Name: HelpBird. MCP server URL: https://helpbird.app/mcp. Authentication: OAuth.
  4. 4Click Create, sign in to HelpBird and click Allow. Then pick HelpBird from the tools of a new chat.

Claude Code

the terminal and the IDE extensions

  1. 1Run the command below (add --scope user to have HelpBird in every project).
  2. 2In Claude Code, type /mcp, pick helpbird and choose Authenticate. Your browser opens: sign in and click Allow.
terminal
claude mcp add --transport http helpbird https://helpbird.app/mcp

Cursor

the editor and its agent

  1. 1Add HelpBird to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project).
  2. 2In Cursor's settings, open the MCP section and click Connect next to helpbird. Sign in to HelpBird, click Allow, and Cursor picks the connection up.
~/.cursor/mcp.json
{
  "mcpServers": {
    "helpbird": { "url": "https://helpbird.app/mcp" }
  }
}

VS Code

GitHub Copilot's agent mode

  1. 1Add HelpBird to .vscode/mcp.json, or run MCP: Add Server from the Command Palette, choose HTTP and paste the URL.
  2. 2Click Start above the server. VS Code asks to sign in: allow it, sign in to HelpBird and click Allow. Then use HelpBird from Copilot Chat in agent mode.
.vscode/mcp.json
{
  "servers": {
    "helpbird": { "type": "http", "url": "https://helpbird.app/mcp" }
  }
}

Any MCP client

Windsurf, Codex, Goose, your own agent…

  1. 1Add a remote (Streamable HTTP) MCP server with the URL https://helpbird.app/mcp.
  2. 2The client signs in with OAuth 2.1 on its own: it discovers the server at /.well-known/oauth-protected-resource/mcp, registers itself and sends you to HelpBird to sign in and click Allow (PKCE, no secret to copy).
  3. 3No OAuth in your client? Use a token instead.

A token, for clients without OAuth

Scripts, CI, older clients

In HelpBird, open Settings → AI agents and create a token. It is shown once; send it as the header Authorization: Bearer hbmcp_…. Keep it out of your repository, and revoke it from the same page when you no longer need it.

Claude Code
claude mcp add --transport http helpbird https://helpbird.app/mcp \
  --header "Authorization: Bearer hbmcp_..."
mcp.json (clients that take headers)
{
  "mcpServers": {
    "helpbird": {
      "url": "https://helpbird.app/mcp",
      "headers": { "Authorization": "Bearer hbmcp_..." }
    }
  }
}
Try asking

Say what you need, in your words.

“What needs my attention in HelpBird today?”
“Answer the open conversations about shipping. Show me each reply before you send it.”
“Write help-center articles, as drafts, for the questions customers searched for and didn't find.”
“Set our business hours to 9–6, Monday to Friday, with an away message, and assign anything urgent to Ana.”
“Which conversations missed our first-response target this week, and why?”
“Install the HelpBird chat on this site, then match its colors to our brand.”

Ready-made jobs

The server also offers prompts your client lists (the “/” menu in Claude):

  • Clear the inbox
    clear_inbox

    Work through the open conversations, most urgent first: answer, assign, tag, snooze or close each one.

  • Improve the AI from recent conversations
    improve_bot

    Find what the AI and the help center couldn't answer lately, and write the articles and prompt changes that would.

  • Set up a new workspace
    setup_workspace

    Take a new HelpBird account from zero to live: install, greeting, hours, look, AI knowledge, team and alerts.

Safe by design

Your agent works for you, not for whoever writes in.

You connect it, as you

Only the account owner can connect an app: you sign in to HelpBird and click Allow. The agent then acts as you, within your plan and through the same checks as the admin panel. Teammates can't connect apps.

Reading changes nothing

27 of the 77 tools only read, and say so to your client. Reading a conversation doesn't even mark it read for your team.

A preview before anything that matters

A reply or a campaign to customers, deleting something, sending data outside your account (a webhook, an alert address, a new teammate) or cancelling your plan first comes back as a preview of exactly what would happen. Nothing changes until you say yes.

No money moves

An agent can't pay, bill your card or refund anything. Asked to change your plan, it gives you a link: you review and confirm on your Billing page (or on Shopify). Cards are only entered in the panel.

Revoke any time

Settings → AI agents lists every connected app and token; disconnect one and it stops at once. Changing your password disconnects them all. Access lasts an hour at a time and renews only while the connection is alive.

What data goes where

What the agent reads (conversations, contacts, articles, settings) goes to the AI provider you connected, under its terms. HelpBird never sees your chat with the assistant, only the tool calls it makes. Your customers' messages reach the agent as data, never as instructions. See the privacy policy.

Need a hand connecting?

Write to us from the contact page or at sales@devcloudsoftware.com, or ask your agent to use its contact_support tool. Developers: the protocol details are in the API docs.