# Chatwithhal MCP server

Source: https://glimind.com/server/mcp-registry%2Fcom.chatwithhal%2Fmcp
Registry id: `mcp-registry/com.chatwithhal/mcp`
Status: live (checked 2026-11-22T15:25:12.945Z)

## Measurements (30 days)

- Uptime: 99.97%
- Checks: 5074
- Outages (90 days): 1

## Install

```json
{
  "mcpServers": {
    "chatwithhal-mcp-server": {
      "type": "http",
      "url": "https://api.chatwithhal.com/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http chatwithhal-mcp-server https://api.chatwithhal.com/mcp
```

## Tools (136)

- `cancel_broadcast`: Cancel a scheduled, in-progress, or paused broadcast. Recipients not yet sent to are marked cancelled.
- `check_sender_domain`: Re-check the project's custom sender domain verification status against Amazon SES.
- `configure_sender_domain`: Configure a custom sender domain for visitor-facing email on this project (Starter plan and above). Returns DNS records (DKIM CNAMEs, and MX/TXT if a mail-from 
- `create_article`: Create an article with an initial translation
- `create_article_group`: Create a new article group
- `create_automation`: Create a new automation
- `create_broadcast`: New to HAL email? Call get_email_capabilities_overview first. Create a draft (or scheduled, if scheduled_at is set) one-off email broadcast. Does not send anyth
- `create_company`: Create a new company
- `create_contact`: Create a new contact
- `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).
- `create_email_campaign`: New to HAL email? Call get_email_capabilities_overview first. Create an email campaign using campaign language instead of workflow graph internals.
- `create_email_template`: New to HAL email? Call get_email_capabilities_overview first. Create a reusable workflow email template.
- `create_guide`: Create a new guide
- `create_webhook`: Create a new webhook
- `create_workflow`: New to HAL email? Call get_email_capabilities_overview first. Create a visitor workflow: a trigger plus a branching graph of condition/send_widget_message/send_
- `delete_broadcast`: Delete a broadcast. Refused while it is actively sending.
- `delete_company`: Permanently 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; it
- `delete_contact`: Permanently 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 a
- `delete_deal`: Delete a deal. A company with no deals left drops out of the pipeline.
- `delete_email_campaign`: Delete an email campaign. Refuses if another workflow in the project still chains into it via trigger_campaign or next_campaign_id.
- `delete_email_image`: Delete an image from a project’s email image library. Remove it from any email templates first, or the image block will break.
- `delete_email_template`: Delete a reusable workflow email template. Existing campaigns keep their embedded copy.
- `delete_guide`: Permanently delete a guide and its execution history
- `delete_webhook`: Delete a webhook
- `delete_workflow`: Delete a visitor workflow. Refuses if another workflow in the project still chains into it via trigger_campaign or next_campaign_id.
- `disable_email_campaign`: Disable an email campaign.
- `enable_email_campaign`: Enable an email campaign.
- `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, 
- `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 conf
- `get_article`: Get an article with translations
- `get_automation`: Get automation details
- `get_broadcast`: Get a single email broadcast, including delivery/open/click counts. With an A/B test, `ab_test` has its settings, `phase` (testing, waiting, winner_sending, don
- `get_broadcast_audience_fields`: List the fields available for building a broadcast audience (contact/company builtins, sampled metadata keys, valid operators per type).
- `get_broadcast_readiness`: Deliverability checklist for a broadcast before sending: sender authentication (custom domain, DMARC, MAIL FROM/SPF), postal address, project bounce/complaint h
- `get_company`: Get a company with contacts, details and its deals. The company stage and deal_value mirror its primary deal.
- `get_contact`: Get a contact with full details, recent activity and the deals they are on
- `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 o
- `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 deliver
- `get_deal`: Get a deal with its company, stage, contacts and stage/amount history
- `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 exp
- `get_email_campaign`: Get email campaign details.
- `get_email_campaign_run`: Get one email campaign run with clicked URLs.
- `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, 
- `get_email_deliverability`: Project email reporting. Always returns: health (last 30 days across every campaign, workflow and broadcast: sent, sent_last_24h, delivered, hard bounces (bounc
- `get_email_template`: Get a reusable workflow email template.
- `get_email_unsubscribe_status`: Check whether an email address is currently suppressed for lifecycle email campaigns, for a given category (default "all").
- `get_guide`: Get guide details
- `get_guide_health`: Which guides had steps fail to anchor recently — the signal that a selector rotted in the target app
- `get_guide_stats`: Per-guide analytics: triggers, completions, completion rate, per-step drop-off, selector misses
- `get_macro`: Get a single shared macro by ID
- `get_message_tags_stats`: Get all project tags with their usage counts
- `get_sender_domain`: Get the custom sender domain (Starter plan and above) configured for this project, including DNS records, verification status, and any Reply-To override (`sende
- `get_statistics`: Get project statistics including responsiveness, conversation volume, and per-agent metrics. Defaults to last 30 days.
- `get_team`: Get a team with its members
- `get_workflow`: Get a visitor workflow including its full node/edge graph definition.
- `get_workflow_builder_reference`: New to HAL email? Call get_email_capabilities_overview first. Static reference for building visitor workflows through create_workflow/update_workflow/validate_w
- `get_workflow_email_defaults`: Get the project default email design used to seed new send_email nodes.
- `get_workflow_execution`: Get one visitor workflow execution.
- `import_conversation`: Import a single historical conversation silently (no webhooks, no notifications). Use for migrating data from other chat platforms.
- `import_conversations`: Import multiple historical conversations in batch (max 100). Each conversation is imported independently — one failure does not affect others. Silent: no webhoo
- `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.
- `list_article_groups`: List all article groups
- `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 
- `list_automations`: List all automations for this project
- `list_broadcast_recipients`: List the per-recipient delivery status for a broadcast.
- `list_broadcasts`: List one-off email broadcasts for a project.
- `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 to
- `list_contacts`: List contacts with optional search
- `list_conversations`: List conversations with filters (status, spam, limit, offset). Each result says whether it is marked as spam.
- `list_crm_stages`: List CRM pipeline stages
- `list_custom_properties`: List visitor custom properties and sampled metadata keys available for campaign predicates and conditions.
- `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,
- `list_email_campaign_runs`: List email campaign runs with delivery, open, and click data.
- `list_email_campaigns`: List email campaigns backed by visitor workflows.
- `list_email_categories`: List a project's email categories used for per-category unsubscribe/preferences (marketing, product updates, transactional, ...). A project with no customized c
- `list_email_images`: List images in a project’s email image library, newest first. Use these for lifecycle/workflow email `image` blocks.
- `list_email_suppressions`: List email addresses suppressed for lifecycle email campaigns in a project.
- `list_email_templates`: List reusable workflow email templates for a project.
- `list_event_names`: List tracked lifecycle event names seen in a project.
- `list_guides`: List all guides for this project
- `list_macros`: List shared macros (available to all team members)
- `list_message_tags`: List all tags defined for this project
- `list_projects`: List projects available to this MCP key. Call this first, then get_email_capabilities_overview for email features.
- `list_teams`: List all teams for this project with member and conversation counts
- `list_test_email_recipients`: List account user emails allowed as workflow/email test recipients.
- `list_webhooks`: List all webhooks for this project
- `list_workflow_executions`: List execution history for a visitor workflow.
- `list_workflows`: List visitor workflows for a project (trigger + branching graph automations), ordered by priority.
- `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
- `preview_broadcast_audience`: Preview who a broadcast (or a candidate audience) would reach: match count, suppressed count, contacts left out by list hygiene (invalid/disposable/role address
- `preview_email_template`: Render an email template preview as subject, preheader, HTML, and plain text.
- `remove_deal_contact`: Remove a contact from a deal
- `remove_sender_domain`: Remove the project's custom sender domain. Visitor-facing email reverts to the default Hal address.
- `reorder_workflows`: Reorder visitor workflows by priority; the first id in the list gets the highest priority.
- `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
- `reset_email_deliverability_health`: Start a fresh 30-day health window for a project that is blocked from sending broadcasts by old bounces or complaints. ONLY use this after the bounced and compl
- `resume_broadcast`: Resume a paused broadcast. Broadcasts auto-pause when their bounce or spam-complaint rate is too high, or when a scheduled send hits a blocking deliverability c
- `schedule_broadcast`: Schedule a draft (or reschedule a scheduled) broadcast to send at a future time.
- `select_broadcast_ab_winner`: End a broadcast's A/B test early and send the winner to the rest of the audience now, instead of waiting for the automatic pick. `ab_test.results` on get_broadc

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
