Agents Index

HAL

OnlineNew

Customer conversations, help center, CRM, deals and email campaigns on HAL (chatwithhal.com).

Visit publisherConnectJSON

What it can do: 80 tools

  • list_projects read-onlyList projects available to this MCP key. Call this first, then get_email_capabilities_overview for email features.
  • list_conversations read-onlyList conversations with filters (status, spam, limit, offset). Each result says whether it is marked as spam.
  • get_conversation read-onlyGet a conversation with its messages and attachment metadata. agents_typing lists teammates drafting a reply right now; if someone is, let them answer instead of replying over them. replied_to_email is set when the conve
  • get_conversation_image read-onlyGet an image attached to a conversation message as MCP image content so the AI client can inspect it. Images over 2 MB are resized and compressed before delivery. Use an attachment ID returned by get_conversation.
  • set_typingShow the visitor and your teammates in the dashboard that a reply is being written. Call it right before you draft a reply the visitor will read, so a live agent sees the conversation is being handled. Do not call it for
  • reply_to_conversationSend an agent message to a conversation. To show a help article to the visitor, write `[label](hal-article:<article id or slug>)` into the `content` of reply_to_conversation. The widget renders it as a clickable card at
  • update_conversationUpdate conversation status, assignment, snooze state, or spam. is_spam true does what "Mark as spam" does in the inbox: the conversation leaves the inbox, is marked read, and the same sender's next conversations in this
  • generate_ai_response_suggestionGenerate an advisory-only HAL AI reply suggestion for the latest visitor message. Call this after get_conversation, then combine HAL's draft, evidence, and confidence with the conversation messages when composing your fi
  • list_article_groups read-onlyList all article groups
  • create_article_groupCreate a new article group
  • update_article_groupUpdate an article group
  • list_articles read-onlyList articles, optionally filtered by group or to published ones. To show a help article to the visitor, write `[label](hal-article:<article id or slug>)` into the `content` of reply_to_conversation. The widget renders i
  • find_relevant_articlesFind published help articles that fit a conversation, in the visitor's language and limited to ones this visitor may see. Matches the visitor's latest message, or `query` when given. Returns up to 6, best match first; we
  • get_article read-onlyGet an article with translations
  • create_articleCreate an article with an initial translation
  • update_articleUpdate article properties or upsert a translation
  • delete_contactPermanently delete a contact. Without confirm: true it only returns a preview of what would be removed. Deletes the contact with its deal links, company links and tracked email threads; its conversations stay, with their
  • list_contacts read-onlyList contacts with optional search
  • get_contact read-onlyGet a contact with full details, recent activity and the deals they are on
  • create_contactCreate a new contact
  • update_contactUpdate a contact
  • delete_companyPermanently delete a company. Without confirm: true it only returns a preview of what would be removed. Deletes the company with its deals and contact links; its contacts stay. Cannot be undone.
  • list_crm_stages read-onlyList CRM pipeline stages
  • list_companies read-onlyList companies with optional search and stage filter. Includes companies with no linked contacts. Paginated.
  • list_companies_by_stage read-onlyRead-only CRM board: list ALL companies grouped by pipeline stage, including companies with no linked contacts and unstaged companies. Returns per-stage deal totals so agents can reconcile Won totals with company rows. C
  • get_company read-onlyGet a company with contacts, details and its deals. The company stage and deal_value mirror its primary deal.
  • link_contact_to_companyLink an existing contact to an existing company. The operation is idempotent and both records must belong to the selected project.
  • create_companyCreate a new company
  • update_companyUpdate a company
  • merge_companiesMerge a duplicate company into a keeper. Contacts, tracked events, and CRM timeline move to the keeper; the source company is deleted. Use when the same org has a HAL-generated row and a later source-system (e.g. Apollo)
  • list_deals read-onlyList deals (sales opportunities). A company can have several deals: new business, expansion, renewal. Each deal has a stage, amount, expected close date, owner, next step and contacts. Filter by company, contact, stage,
  • get_deal_pipeline read-onlySummarize the sales pipeline: per stage the number of deals, total and probability-weighted amount, plus open/won/lost totals, win rate and open deals whose expected close date has passed. Use list_deals for the deals th
  • get_deal read-onlyGet a deal with its company, stage, contacts and stage/amount history
  • create_dealCreate a deal for a company. The company's own stage and value follow its primary deal (its newest open new-business deal).
  • update_dealUpdate a deal. Moving it to a 100% stage marks it won and a 0% stage marks it lost (pass lost_reason); moving it back to an open stage reopens it.
  • set_deal_contactAdd a contact to a deal, or change their role on it
  • remove_deal_contactRemove a contact from a deal
  • delete_dealDelete a deal. A company with no deals left drops out of the pipeline.
  • get_email_capabilities_overview read-onlyOrientation for HAL email features: campaigns vs workflows vs broadcasts, templates vs project defaults vs inline design, sender domains, images, test sending, track_event, and unsubscribe/suppression. Call this before c
  • list_email_templates read-onlyList reusable workflow email templates for a project.

…and 40 more.

Connect it

Claude Code
claude mcp add --transport http hal https://api.chatwithhal.com/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://api.chatwithhal.com/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "hal": {
      "url": "https://api.chatwithhal.com/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "hal": {
      "type": "http",
      "url": "https://api.chatwithhal.com/mcp"
    }
  }
}

Questions

What does HAL do?

Customer conversations, help center, CRM, deals and email campaigns on HAL (chatwithhal.com). It exposes 80 tools to AI assistants.

What tools does HAL provide?

80 tools, including list_projects, list_conversations, get_conversation, get_conversation_image, set_typing, reply_to_conversation, update_conversation, generate_ai_response_suggestion, list_article_groups, create_article_group, update_article_group, list_articles….

How do I connect HAL to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://api.chatwithhal.com/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does HAL require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is HAL online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes HAL?

chatwithhal.com. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Communication