> ## Documentation Index
> Fetch the complete documentation index at: https://docs.howly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> What the Howly MCP is, and what Claude can do with it.

Howly exposes your portal through a Model Context Protocol (MCP) server, so AI assistants like Claude can query your workflow health and issues directly, in plain language, without opening Howly.

Every tool is **read-only**. Claude can inspect and explain your workflows, but it cannot change, publish, delete, or activate anything. The fixes always happen in HubSpot, by a person.

> [!NOTE]
>
> The Howly MCP is available on Howly Pro and Agency, and during the trial.

## The tools

The server exposes four read-only tools. Your assistant picks the right one based on what you ask.

> [card] get\_portal\_health
>
> The overall health score out of 100, total and active workflow counts, and issue counts by category and severity.

> [card] get\_workflow\_issues
>
> The full list of structural issues, grouped by severity: broken enrollments, circular dependencies, duplicate actions, stale, orphan, and empty workflows.

> [card] list\_workflows
>
> Every workflow in the connected portal, so your assistant can find the one you mean.

> [card] get\_workflow
>
> The full detail of a single workflow: its triggers, actions, and connections.

Answers come straight from your live Howly data, the same analysis you see in the app.

## When to use it

Reach for the MCP when you'd rather ask a question than click through the app. It's built for the moment you want a prioritized plan, a quick answer about one workflow, or a cleanup summary you can paste into a client update. See [Use Cases](https://docs.howly.io/mcp/use-cases) and the [Prompt Library](https://docs.howly.io/mcp/prompt-library) for specifics.

## What it cannot do

The connection is read-only. It cannot edit or create workflows, turn them on or off, delete them, publish changes, enroll or unenroll contacts, modify records, create lists, or change properties.

> [!NOTE]
>
> Pair the Howly MCP with HubSpot's own MCP and you can ask about your workflows and the rest of your CRM in the same conversation.

Ready to connect it? Head to [Connect](https://docs.howly.io/mcp/connect).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.