> ## 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.

<Info>
  The Howly MCP is available on Howly Pro and Agency, and during the trial.
</Info>

## The tools

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

<CardGroup cols={2}>
  <Card title="get_portal_health">
    The overall health score out of 100, total and active workflow counts, and issue counts by category and severity.
  </Card>

  <Card title="get_workflow_issues">
    The full list of structural issues, grouped by severity: broken enrollments, circular dependencies, duplicate actions, stale, orphan, and empty workflows.
  </Card>

  <Card title="list_workflows">
    Every workflow in the connected portal, so your assistant can find the one you mean.
  </Card>

  <Card title="get_workflow">
    The full detail of a single workflow: its triggers, actions, and connections.
  </Card>
</CardGroup>

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](/mcp/use-cases) and the [Prompt Library](/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.
</Note>

Ready to connect it? Head to [Connect](/mcp/connect).


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