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

# HoopAI MCP Server

> Connect any AI assistant directly to your HoopAI data and tools using the Model Context Protocol (MCP).

The HoopAI MCP server lets AI assistants talk directly to your HoopAI account — contacts, conversations, calendars, opportunities, payments, social media, and more — through a standard protocol that works with any MCP-compatible client.

Think of it as a bridge: your AI can query, automate, and orchestrate everything in your HoopAI account using natural language, in any app that supports HTTP-based MCP (Cursor, Windsurf, n8n, LangGraph, OpenAI Playground, and more).

## What you can do

<CardGroup cols={2}>
  <Card title="Contact management on autopilot" icon="address-book">
    Fetch, update, or create contacts via AI prompts. Tag and segment contacts for targeted campaigns through a chat interface.

    *"Show me all contacts added last week and tag them as 'New Lead'."*
  </Card>

  <Card title="Conversational AI that texts for you" icon="comments">
    Send messages to any conversation using your AI agent. Search conversations by keywords, status, or participant.

    *"Find all unread messages and send a follow-up: 'Hey! Just checking in.'"*
  </Card>

  <Card title="Multi-step workflow automation" icon="bolt">
    Chain multiple actions into true business workflows.

    *"On new contact creation, tag them, send a welcome message, and add to a pipeline."*
  </Card>

  <Card title="Payment and transaction intelligence" icon="credit-card">
    Fetch order details and transaction history on demand. Build AI-powered dashboards for payment analysis.

    *"Show me the last 10 transactions over \$100 and flag any with a refund request."*
  </Card>
</CardGroup>

## 36 available tools

The MCP server exposes tools across 8 modules:

| Module            | Tools available                                                           |
| ----------------- | ------------------------------------------------------------------------- |
| **Contacts**      | Get, create, update, upsert, get all tasks, add/remove tags               |
| **Conversations** | Search, get messages, send messages                                       |
| **Calendars**     | Get calendar events, get appointment notes                                |
| **Opportunities** | Search, get pipelines, get, update                                        |
| **Payments**      | Get order by ID, list transactions                                        |
| **Social Media**  | Create, edit, get, list posts; get accounts and statistics                |
| **Blogs**         | Create, update, get posts; get authors, categories, sites; check URL slug |
| **Emails**        | Fetch and create email templates                                          |

See [Platform MCP Server](/developer/mcp/platform-mcp-server) for the full tool reference with endpoint names and descriptions.

## How it connects

```
Your AI client → HoopAI MCP Server → Your HoopAI account data
```

**Endpoint:** `https://services.leadconnectorhq.com/mcp/`
**Transport:** HTTP Streamable
**Auth:** Private Integration Token (PIT) as Bearer header

The `locationId` can be passed as a header in your config or mentioned naturally in your prompts — the server supports both patterns.

## Quick setup

<Steps>
  <Step title="Get a Private Integration Token">
    Go to **Settings → Integrations → Private Integrations** in your HoopAI account. Create a new integration and select the scopes for the tools you need.
  </Step>

  <Step title="Configure your client">
    Add the MCP server URL and your token to your agent or MCP client config. See the [Quickstart](/developer/mcp/quickstart) for step-by-step instructions.
  </Step>

  <Step title="Start making requests">
    Send natural language requests to your agent. It will call the right MCP tools automatically.
  </Step>
</Steps>

## Build guides

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/developer/mcp/quickstart">
    Configure the MCP server with n8n, LangGraph, or any HTTP-compatible client
  </Card>

  <Card title="Tool reference" icon="table" href="/developer/mcp/platform-mcp-server">
    Full list of 36 tools, endpoint names, and required scopes
  </Card>

  <Card title="Build an agent" icon="robot" href="/developer/mcp/subagents">
    LangGraph and multi-agent patterns for HoopAI automation
  </Card>

  <Card title="n8n integration" icon="diagram-project" href="/developer/mcp/hoopai-proxy">
    Connect HoopAI MCP to n8n workflows
  </Card>
</CardGroup>