> ## 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.
# MCP Tool Reference
> Complete list of 36 MCP tools, endpoint names, and required scopes for the HoopAI MCP server.
## Connection details
| Setting | Value |
| ------------------- | ----------------------------------------------------------------- |
| **Endpoint** | `https://services.leadconnectorhq.com/mcp/` |
| **Transport** | HTTP Streamable |
| **Auth header** | `Authorization: Bearer YOUR_API_KEY` |
| **Location header** | `locationId: YOUR_LOCATION_ID` *(optional — can pass in prompts)* |
## All 36 tools
| # | Tool name | Endpoint / ID | Description |
| -- | --------------------------- | -------------------------------------------------- | ------------------------------------------------------------- |
| 1 | Get Calendar Events | `calendars_get-calendar-events` | Get calendar events (requires 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` | Get all tasks for a contact |
| 4 | Add Tags | `contacts_add-tags` | Add one or more tags to a contact |
| 5 | Remove Tags | `contacts_remove-tags` | Remove tags from a contact |
| 6 | Get Contact | `contacts_get-contact` | Fetch a single contact's details |
| 7 | Update Contact | `contacts_update-contact` | Update fields on an existing contact |
| 8 | Upsert Contact | `contacts_upsert-contact` | Update if exists, create if not |
| 9 | Create Contact | `contacts_create-contact` | Create a new contact |
| 10 | Get Contacts | `contacts_get-contacts` | Get a list of contacts |
| 11 | Search Conversation | `conversations_search-conversation` | Search, filter, and sort conversations |
| 12 | Get Messages | `conversations_get-messages` | Get all messages in a conversation by ID |
| 13 | Send a New Message | `conversations_send-a-new-message` | Send a message into a conversation thread |
| 14 | Get Location | `locations_get-location` | Get account details by Location 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` | Retrieve all opportunity pipelines |
| 18 | Get Opportunity | `opportunities_get-opportunity` | Fetch an opportunity by ID |
| 19 | Update Opportunity | `opportunities_update-opportunity` | Update an existing opportunity |
| 20 | Get Order by ID | `payments_get-order-by-id` | Fetch order details by unique order ID |
| 21 | List Transactions | `payments_list-transactions` | Paginated transaction list with filtering |
| 22 | Edit Post | `social-media-posting_edit-post` | Modify an existing social media post |
| 23 | Create Post | `social-media-posting_create-post` | Create a new post for multiple platforms |
| 24 | Get Post | `social-media-posting_get-post` | Get detailed info for a specific post |
| 25 | Get Social Media Accounts | `social-media-posting_get-account` | List connected social media accounts |
| 26 | Get Social Media Statistics | `social-media-posting_get-social-media-statistics` | Analytics data for social accounts |
| 27 | Get Posts | `social-media-posting_get-posts` | List social media posts |
| 28 | Check URL Slug | `blogs_check-url-slug-exists` | Validate a URL slug before publishing |
| 29 | Get Blog Post | `blogs_get-blog-post` | Get blog posts for a specific blog site |
| 30 | Get Blog Categories | `blogs_get-all-categories-by-location` | Get all blog categories for a location |
| 31 | Create Blog Post | `blogs_create-blog-post` | Create a new blog post |
| 32 | Get All Blog Authors | `blogs_get-all-blog-authors-by-location` | Get all blog authors for a location |
| 33 | Get All Blogs | `blogs_get-blogs` | List all blog sites |
| 34 | Update Blog Post | `blogs_update-blog-post` | Modify an existing blog post |
| 35 | Get Email Templates | `emails_fetch-template` | Retrieve email templates for a location |
| 36 | Create Email Template | `emails_create-template` | Create a new email template |
## Required scopes
Your Private Integration Token must include the following scopes for full tool access. You can select a subset if you only need specific tools.
* View Contacts
* Edit Contacts
* View Conversations
* Edit Conversations
* View Conversation Messages
* Edit Conversation Messages
* View Opportunities
* Edit Opportunities
* View Calendars
* Edit Calendars
* View Calendar Events
* Edit Calendar Events
* View Payment Orders
* View Payment Transactions
* View Social Media Posts
* Edit Social Media Posts
* View Social Media Accounts
* socialplannerstatisticsreadonly
* blogslistreadonly
* blogspostsreadonly
* View Blog Authors
* View Blog Categories
* Update Blog Post
* Check Blog Post Slug
* Create Blog Post
* View Email Templates
* Create, Update and Delete Email Templates
* View Custom Fields
* View Forms
* View Locations
You'll be prompted to select scopes when creating your Private Integration under **Settings → Integrations → Private Integrations**.
## Roadmap
* **npx package** — for clients that don't yet support HTTP Streamable (including Claude Desktop)
* **OAuth support**
* **250+ tools** as part of a unified orchestrator layer — a single connector for the entire HoopAI ecosystem without consuming extra LLM tokens