HAL

Reliability

Status and outage history · Atom feed · Watch with other listings

How to connect

Add it to any MCP client that supports remote servers.

{
  "mcpServers": {
    "hal": {
      "type": "http",
      "url": "https://api.chatwithhal.com/mcp"
    }
  }
}

134 tools

• list_projects

  List projects available to this MCP key. Call this first, then get_email_capabilities_overview for email features.

• list_conversations

  List conversations with filters (status, spam, limit, offset). Each result says whether it is marked as spam.

• get_conversation

  Get 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 conversation started as a reply to a campaign, workflow or…

• get_conversation_image

  Get 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_typing

  Show 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 internal notes, for reading or summarizing, or when you…

• reply_to_conversation

  Send 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 that spot, on its own line (it is not an inline link inside…

• update_conversation

  Update 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 project go straight to spam; is_spam false undoes it and…

• generate_ai_response_suggestion

  Generate 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 final answer. This tool never sends a message to the visitor…

• list_article_groups

  List all article groups

• create_article_group

  Create a new article group

• update_article_group

  Update an article group

• list_articles

  List 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 it as a clickable card at that spot, on its own line (it is…

• find_relevant_articles

  Find 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; weaker results can be only loosely related, so check the…

• get_article

  Get an article with translations

• create_article

  Create an article with an initial translation

• update_article

  Update article properties or upsert a translation

• list_contacts

  List contacts with optional search

• get_contact

  Get a contact with full details, recent activity and the deals they are on

• create_contact

  Create a new contact

• update_contact

  Update a contact

• list_crm_stages

  List CRM pipeline stages

• list_companies

  List companies with optional search and stage filter. Includes companies with no linked contacts. Paginated.

• list_companies_by_stage

  Read-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. Company stage and deal value mirror the company primary…

• get_company

  Get a company with contacts, details and its deals. The company stage and deal_value mirror its primary deal.

• link_contact_to_company

  Link an existing contact to an existing company. The operation is idempotent and both records must belong to the selected project.

• create_company

  Create a new company

• update_company

  Update a company

• merge_companies

  Merge 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) id row. Refuses to merge companies that already have…

• list_deals

  List 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, owner or status.

• get_deal_pipeline

  Summarize 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 themselves.

• get_deal

  Get a deal with its company, stage, contacts and stage/amount history

• create_deal

  Create a deal for a company. The company's own stage and value follow its primary deal (its newest open new-business deal).

• update_deal

  Update 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_contact

  Add a contact to a deal, or change their role on it

• remove_deal_contact

  Remove a contact from a deal

• delete_deal

  Delete a deal. A company with no deals left drops out of the pipeline.

• get_email_capabilities_overview

  Orientation 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 creating any campaign, workflow, broadcast, or template.

• list_email_templates

  List reusable workflow email templates for a project.

• get_email_template

  Get a reusable workflow email template.

• create_email_template

  New to HAL email? Call get_email_capabilities_overview first. Create a reusable workflow email template.

Security scan

Recent checks