Welcome to GrowhtHub Knowledge Base Hub

Welcome to GrowhtHub Knowledge Base Hub

MCP Server Setup Guide

Overview

The MCP Server is a powerful, standardized protocol that allows AI agents to seamlessly interact with GrowthHub - reading and writing data without the need for SDKs or complex integrations.

With a single connection, your AI can access essential tools like Calendars, Contacts, Conversations, Opportunities, and Payments.

TABLE OF CONTENTS

MCP Server Setup Guide

Overview

The MCP Server is a powerful, standardized protocol that allows AI agents to seamlessly interact with GrowthHub - reading and writing data without the need for SDKs or complex integrations.

With a single connection, your AI can access essential tools like Calendars, Contacts, Conversations, Opportunities, and Payments.

TABLE OF CONTENTS

Why Use the MCP Server?

Connecting your AI agents to GrowthHub is now faster, safer, and more scalable.

  • Standardized Access
    Query and update data through one unified protocol.

  • Fast Integration
    No SDK required—works with any HTTP-enabled client.

  • Secure by Design
    Uses Private Integration Tokens (PITs) with permission-based access.

  • Scalable System
    Built to expand to 250+ tools.

  • Flexible Compatibility
    Works with tools like Cursor, Windsurf, and OpenAI Playground.

Available Tools (Top 36)

Below is the initial set of tools your AI agents can access:

Calendar & Scheduling

#

Tool

Endpoint

Description

1

Get Calendar Events

calendars_get-calendar-events

Get calendar events using userId, groupId, or calendarId.

2

Get Appointment Notes

calendars_get-appointment-notes

Retrieve notes for a specific appointment.

3

Get All Tasks

contacts_get-all-tasks

Retrieve all tasks for a contact.

4

Add Tags

contacts_add-tags

Add tags to a contact.

5

Remove Tags

contacts_remove-tags

Remove tags from a contact.

6

Get Contact

contacts_get-contact

Fetch contact details.

7

Update Contact

contacts_update-contact

Update a contact.

8

Upsert Contact

contacts_upsert-contact

Update or create a contact.

9

Create Contact

contacts_create-contact

Create a new contact.

10

Get Contacts

contacts_get-contacts

Fetch all contacts.

11

Search Conversation

conversations_search-conversation

Search/filter/sort conversations.

12

Get Messages

conversations_get-messages

Retrieve messages by conversation ID.

13

Send a New Message

conversations_send-a-new-message

Send a message to a conversation thread.

14

Get Location

locations_get-location

Get location details by ID.

15

Get Custom Fields

locations_get-custom-fields

Retrieve custom field definitions for a location.

16

Search Opportunity

opportunities_search-opportunity

Search for opportunities by criteria.

17

Get Pipelines

opportunities_get-pipelines

Fetch all opportunity pipelines.

18

Get Opportunity

opportunities_get-opportunity

Fetch opportunity details by ID.

19

Update Opportunity

opportunities_update-opportunity

Update opportunity details.

20

Get Order by ID

payments_get-order-by-id

Retrieve payment order details.

21

List Transactions

payments_list-transactions

Fetch paginated list of transactions.

22

Check Blog URL Slug

blogs_check-url-slug-exists

Check the blog slug which is needed before publishing any blog post.

23

Update Blog Post

blogs_update-blog-post

Update blog post for any given blog site

24

Create Blog Post

blogs_create-blog-post

create blog post for any given blog site

25

Get Blog Authors

blogs_get-all-blog-authors-by-location

get blog authors for a given location ID

26

Get Blog Categories

blogs_get-all-categories-by-location

get blog categories for a given location ID

27

Get Blog Posts by Blog ID

blogs_get-blog-post

get blog posts for any given blog site using blog ID

28

Get Blogs by Location

blogs_get-blogs

get blogs using Location ID

29

Create Email Template

emails_create-template

Create a new template

30

Get Email Templates

emails_fetch-template

Fetch email templates by location id

31

Get Social Media Accounts

socialmediaposting_get-account

Get list of accounts and groups

32

Get Social Media Statistics

socialmediaposting_get-social-media-statistics

Retrieve analytics data for multiple social media accounts

33

Create Social Media Post

socialmediaposting_create-post

Create posts for all supported platforms

34

Get Social Media Post

socialmediaposting_get-post

Get social media post

35

Get Social Media Posts

socialmediaposting_get-posts

Get social media posts

36

Update Social Media Post

socialmediaposting_edit-post

Edit social media post

How to Set Up the MCP Server

Step 1: Configure Your Agent or Client

Add the MCP endpoint and required headers:

json

CopyEdit

{

  "mcpServers": {

    "prod-growthhub-mcp": {

      "url": "https://services.leadconnectorhq.com/mcp/",

      "headers": {

        "Authorization": "Bearer <your-token>",

        "locationId": "<sub-account-id>"

      }

    }

  }

}

Step 2: Get Your Private Integration Token (PIT)

1. Go to Settings → Private Integrations in your GrowthHub location.

2. Click Create New Integration.

3. Select the required scopes (listed below).

4. Copy and securely store your token.

Required Scopes

Make sure your PIT includes access to:

  • View/Edit Contacts

  • View/Edit Conversations

  • View/Edit Conversation Messages

  • View/Edit Opportunities

  • View Calendars & Events

  • View Locations

  • View Payment Orders & Transactions

  • View Custom Fields

  • View Forms

Blog Permissions

  • Check Blog Post Slug

  • Update Blog Post

  • Create Blog Post

  • View Blog Authors

  • View Blog Categories

  • blogspostsreadonly

  • blogslistreadonly

Email Permissions

  • Create, Update, Delete Email Templates

  • View Email Templates

Social Media Permissions

  • View Accounts

  • View Statistics

  • Edit Posts

  • View Posts

Step 3: Start Building

Your AI agents can now execute tool actions using natural language, automatically translated into secure API calls via MCP.

Example Tool Call

Python Example:

python

CopyEdit

import requests

headers = {

    "Authorization": "Bearer YOUR_PIT_TOKEN",

    "locationId": "YOUR_LOCATION_ID"

}

data = {

    "tool": "contacts_get-contact",

    "input": {

        "contactId": "abc123"

    }

}

response = requests.post(

    "https://services.leadconnectorhq.com/mcp/",

    headers=headers,

    json=data

)

print(response.json())

Roadmap & Vision

The MCP Server is continuously evolving. Upcoming developments include:

  • Dedicated MCP servers per service

  • npx package for non-HTTP clients (e.g., Claude Desktop)

  • OAuth support for advanced authentication

  • Expansion to 250+ tools

  • Full business automation across GrowthHub

Navigate to Email Marketing

1. Navigate to Email Marketing.

2. Under Email Campaigns, start a new email campaign or open an existing one you wish to edit.