{"id":"com.chatwithhal/mcp","slug":"com-chatwithhal-mcp","title":"HAL","description":"Customer conversations, help center, CRM, deals and email campaigns on HAL (chatwithhal.com).","version":"1.0.0","publisher":{"kind":"domain","id":"chatwithhal.com","label":"chatwithhal.com","url":"https://chatwithhal.com"},"website":"https://chatwithhal.com/docs/mcp","repository":"","remotes":[{"type":"streamable-http","url":"https://api.chatwithhal.com/mcp","headers":[{"description":"Bearer <key>: an account MCP key or a project MCP key (hal_mk_…), created in HAL under Settings → API.","isRequired":true,"value":"Bearer {api_key}","isSecret":true,"variables":{"api_key":{"description":"HAL MCP key: an account key (hal_mcp_…) or a project key (hal_mk_…), from Settings → API.","isRequired":true,"isSecret":true}},"name":"Authorization"}]}],"packages":[],"published":"2026-10-30","updated":"2026-10-30","status":"online","auth":"","latency_ms":1646,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"list_projects","title":"List projects","description":"List projects available to this MCP key. Call this first, then get_email_capabilities_overview for email features.","read_only":true},{"name":"list_conversations","title":"List conversations","description":"List conversations with filters (status, spam, limit, offset). Each result says whether it is marked as spam.","read_only":true},{"name":"get_conversation","title":"Get conversation","description":"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 broadcast email. Call get_conversation_image with an image attachment ID to inspect its visual content. To incorporate HAL's o","read_only":true},{"name":"get_conversation_image","title":"Get conversation image","description":"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.","read_only":true},{"name":"set_typing","title":"Set typing","description":"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 are not going to reply. reply_to_conversation clears it; call again with is_typing false if you decide not to reply.","read_only":false},{"name":"reply_to_conversation","title":"Reply to conversation","description":"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 a sentence), so put it between sentences or paragraphs, e.g. \"Refunds take 5 days.\\n[Refund policy](hal-article:refund-p","read_only":false},{"name":"update_conversation","title":"Update conversation","description":"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 lets the sender back in. The change is recorded in the conversation's activity as done via MCP. Use list_conversations with","read_only":false},{"name":"generate_ai_response_suggestion","title":"Generate ai response suggestion","description":"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, even when project auto-send or AI deflection is enabled.","read_only":false},{"name":"list_article_groups","title":"List article groups","description":"List all article groups","read_only":true},{"name":"create_article_group","title":"Create article group","description":"Create a new article group","read_only":false},{"name":"update_article_group","title":"Update article group","description":"Update an article group","read_only":false},{"name":"list_articles","title":"List articles","description":"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 not an inline link inside a sentence), so put it between sentences or paragraphs, e.g. \"Refunds take 5 days.\\n[Refund pol","read_only":true},{"name":"find_relevant_articles","title":"Find relevant articles","description":"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 title and excerpt before sharing one. Read-only; uses no AI quota. Each result has `insert`, the exact markup to put in the r","read_only":false},{"name":"get_article","title":"Get article","description":"Get an article with translations","read_only":true},{"name":"create_article","title":"Create article","description":"Create an article with an initial translation","read_only":false},{"name":"update_article","title":"Update article","description":"Update article properties or upsert a translation","read_only":false},{"name":"delete_contact","title":"Delete contact","description":"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 and tracked email threads; its conversations stay, with their visitors made anonymous. Cannot be undone.","read_only":false},{"name":"list_contacts","title":"List contacts","description":"List contacts with optional search","read_only":true},{"name":"get_contact","title":"Get contact","description":"Get a contact with full details, recent activity and the deals they are on","read_only":true},{"name":"create_contact","title":"Create contact","description":"Create a new contact","read_only":false},{"name":"update_contact","title":"Update contact","description":"Update a contact","read_only":false},{"name":"delete_company","title":"Delete company","description":"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; its contacts stay. Cannot be undone.","read_only":false},{"name":"list_crm_stages","title":"List crm stages","description":"List CRM pipeline stages","read_only":true},{"name":"list_companies","title":"List companies","description":"List companies with optional search and stage filter. Includes companies with no linked contacts. Paginated.","read_only":true},{"name":"list_companies_by_stage","title":"List companies by stage","description":"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 deal; use list_deals to see every deal, including expansions and renewals.","read_only":true},{"name":"get_company","title":"Get company","description":"Get a company with contacts, details and its deals. The company stage and deal_value mirror its primary deal.","read_only":true},{"name":"link_contact_to_company","title":"Link contact to company","description":"Link an existing contact to an existing company. The operation is idempotent and both records must belong to the selected project.","read_only":false},{"name":"create_company","title":"Create company","description":"Create a new company","read_only":false},{"name":"update_company","title":"Update company","description":"Update a company","read_only":false},{"name":"merge_companies","title":"Merge companies","description":"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 different external ids.","read_only":false},{"name":"list_deals","title":"List deals","description":"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.","read_only":true},{"name":"get_deal_pipeline","title":"Get deal pipeline","description":"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.","read_only":true},{"name":"get_deal","title":"Get deal","description":"Get a deal with its company, stage, contacts and stage/amount history","read_only":true},{"name":"create_deal","title":"Create deal","description":"Create a deal for a company. The company's own stage and value follow its primary deal (its newest open new-business deal).","read_only":false},{"name":"update_deal","title":"Update deal","description":"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.","read_only":false},{"name":"set_deal_contact","title":"Set deal contact","description":"Add a contact to a deal, or change their role on it","read_only":false},{"name":"remove_deal_contact","title":"Remove deal contact","description":"Remove a contact from a deal","read_only":false},{"name":"delete_deal","title":"Delete deal","description":"Delete a deal. A company with no deals left drops out of the pipeline.","read_only":false},{"name":"get_email_capabilities_overview","title":"Get email capabilities overview","description":"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.","read_only":true},{"name":"list_email_templates","title":"List email templates","description":"List reusable workflow email templates for a project.","read_only":true},{"name":"get_email_template","title":"Get email template","description":"Get a reusable workflow email template.","read_only":true},{"name":"create_email_template","title":"Create email template","description":"New to HAL email? Call get_email_capabilities_overview first. Create a reusable workflow email template.","read_only":false},{"name":"update_email_template","title":"Update email template","description":"Update a reusable workflow email template.","read_only":false},{"name":"delete_email_template","title":"Delete email template","description":"Delete a reusable workflow email template. Existing campaigns keep their embedded copy.","read_only":false},{"name":"preview_email_template","title":"Preview email template","description":"Render an email template preview as subject, preheader, HTML, and plain text.","read_only":true},{"name":"validate_email_template","title":"Validate email template","description":"Validate an email template and return AI-client-friendly errors.","read_only":true},{"name":"send_test_email_template","title":"Send test email template","description":"Send a workflow email template test to an account user email address only.","read_only":false},{"name":"send_test_email_campaign","title":"Send test email campaign","description":"Send a test email for an existing email campaign to an account user email address only.","read_only":false},{"name":"list_email_suppressions","title":"List email suppressions","description":"List email addresses suppressed for lifecycle email campaigns in a project.","read_only":true},{"name":"suppress_email_recipient","title":"Suppress email recipient","description":"Suppress an email address so lifecycle email campaigns skip it. Defaults to category \"all\" (blocks everything); pass a specific category key (see list_email_categories) to block only that category.","read_only":false},{"name":"unsuppress_email_recipient","title":"Unsuppress email recipient","description":"Remove an email address from the lifecycle email suppression list. Omit category to lift every suppression on the address (bounce/complaint rows are never removed); pass category to lift only that one.","read_only":false},{"name":"get_email_unsubscribe_status","title":"Get email unsubscribe status","description":"Check whether an email address is currently suppressed for lifecycle email campaigns, for a given category (default \"all\").","read_only":true},{"name":"list_email_campaigns","title":"List email campaigns","description":"List email campaigns backed by visitor workflows.","read_only":true},{"name":"get_email_campaign","title":"Get email campaign","description":"Get email campaign details.","read_only":true},{"name":"list_event_names","title":"List event names","description":"List tracked lifecycle event names seen in a project.","read_only":true},{"name":"list_custom_properties","title":"List custom properties","description":"List visitor custom properties and sampled metadata keys available for campaign predicates and conditions.","read_only":true},{"name":"create_email_campaign","title":"Create email campaign","description":"New to HAL email? Call get_email_capabilities_overview first. Create an email campaign using campaign language instead of workflow graph internals.","read_only":false},{"name":"update_email_campaign","title":"Update email campaign","description":"Update an email campaign.","read_only":false},{"name":"enable_email_campaign","title":"Enable email campaign","description":"Enable an email campaign.","read_only":false},{"name":"disable_email_campaign","title":"Disable email campaign","description":"Disable an email campaign.","read_only":false},{"name":"delete_email_campaign","title":"Delete email campaign","description":"Delete an email campaign. Refuses if another workflow in the project still chains into it via trigger_campaign or next_campaign_id.","read_only":false},{"name":"list_email_campaign_runs","title":"List email campaign runs","description":"List email campaign runs with delivery, open, and click data.","read_only":true},{"name":"get_email_campaign_run","title":"Get email campaign run","description":"Get one email campaign run with clicked URLs.","read_only":true},{"name":"list_email_categories","title":"List email categories","description":"List a project's email categories used for per-category unsubscribe/preferences (marketing, product updates, transactional, ...). A project with no customized categories returns the built-in defaults.","read_only":true},{"name":"update_email_categories","title":"Update email categories","description":"Replace the full set of email categories for a project (upserts by key, removes any key not included). Refused with the referencing suppressions/broadcasts/workflows if a key still in use would be removed.","read_only":false},{"name":"list_email_images","title":"List email images","description":"List images in a project’s email image library, newest first. Use these for lifecycle/workflow email `image` blocks.","read_only":true},{"name":"upload_email_image","title":"Upload email image","description":"Upload an image to a project's email image library so it can be used in lifecycle/workflow email `image` blocks (email_block_types.image.url must be an absolute URL — external hosting is no longer required). Provide exactly one of data_base64 (with mime_type) or source_url. Use email_url in email image blocks (image.url).","read_only":false},{"name":"delete_email_image","title":"Delete email image","description":"Delete an image from a project’s email image library. Remove it from any email templates first, or the image block will break.","read_only":false},{"name":"list_broadcasts","title":"List broadcasts","description":"List one-off email broadcasts for a project.","read_only":true},{"name":"get_broadcast","title":"Get broadcast","description":"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, done, skipped, cancelled), `ends_at` (automatic winner pick), the `winner`, and `results` (test-group sent/opens/clicks/rates per variant plus a confidence score).","read_only":true},{"name":"create_broadcast","title":"Create broadcast","description":"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 anything.","read_only":false},{"name":"update_broadcast","title":"Update broadcast","description":"Update a draft or scheduled broadcast (name, email content, audience, schedule, list-hygiene or tracking options, A/B test).","read_only":false},{"name":"delete_broadcast","title":"Delete broadcast","description":"Delete a broadcast. Refused while it is actively sending.","read_only":false},{"name":"preview_broadcast_audience","title":"Preview broadcast audience","description":"Preview who a broadcast (or a candidate audience) would reach: match count, suppressed count, contacts left out by list hygiene (invalid/disposable/role addresses, unengaged, recently emailed) per reason, and a sample.","read_only":true},{"name":"get_broadcast_audience_fields","title":"Get broadcast audience fields","description":"List the fields available for building a broadcast audience (contact/company builtins, sampled metadata keys, valid operators per type).","read_only":true},{"name":"send_test_broadcast_email","title":"Send test broadcast email","description":"Send a test of a broadcast email to an account user email address only (never to real contacts).","read_only":false},{"name":"schedule_broadcast","title":"Schedule broadcast","description":"Schedule a draft (or reschedule a scheduled) broadcast to send at a future time.","read_only":false},{"name":"send_broadcast_now","title":"Send broadcast now","description":"IMMEDIATELY sends this broadcast to its whole live audience - a real, irreversible email blast to real contacts, not a test. You MUST call preview_broadcast_audience first and pass its exact `count` as confirm_recipient_count; a mismatch is refused. Call get_broadcast_readiness first too: sends with blocking deliverability checks are refused. Only call this after the user has explicitly confirmed ","read_only":false},{"name":"cancel_broadcast","title":"Cancel broadcast","description":"Cancel a scheduled, in-progress, or paused broadcast. Recipients not yet sent to are marked cancelled.","read_only":false},{"name":"list_broadcast_recipients","title":"List broadcast recipients","description":"List the per-recipient delivery status for a broadcast.","read_only":true}],"server_info":{"name":"@chatwithhal/mcp","version":"1.0.0"},"category":"communication","tags":["sales","marketing","news"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-30","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/com-chatwithhal-mcp/"}