MCP Quickstart

1. Direct MCP for clients that support streamable_http
2. HoopAI MCP Proxy for clients that only support stdio

​

Prerequisites

• A HoopAI Private Integration Token (PIT) or OAuth access token
• A locationId to scope tool calls
• Scopes for the modules you plan to use (contacts, conversations, calendars, opportunities, payments, etc.)

​

Option A: Direct MCP (recommended)

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

• Authorization: Bearer <token>
• locationId: <your-location-id>

​

Example: LangGraph MCP client

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient(
    {
        "ghl": {
            "url": "https://services.leadconnectorhq.com/mcp/",
            "transport": "streamable_http",
            "headers": {
                "Authorization": "Bearer your-token",
                "locationId": "your-location-id"
            }
        }
    }
)

​

Example: n8n MCP client

• MCP URL: https://services.leadconnectorhq.com/mcp/
• Transport: HTTP Streamable
• Header: Authorization with Bearer <token>
• Provide locationId as header or prompt context

​

Option B: HoopAI MCP Proxy (stdio)

{
  "mcpServers": {
    "hoopai": {
      "command": "npx",
      "args": [
        "@hoopai/leadconnector-mcp-proxy"
      ],
      "env": {
        "HOOPAI_ACCESS_TOKEN": "your-token",
        "HOOPAI_LOCATION_ID": "your-location-id",
        "HOOPAI_MCP_SERVER_URL": "https://services.leadconnectorhq.com/mcp/",
        "HOOPAI_MCP_MODE": "header"
      }
    }
  }
}

​

Smoke test prompts

• “Show me my last 10 contacts”
• “Find unread conversations and summarize them”
• “Check next available slots for tomorrow”
• “Move opportunity X to the next pipeline stage”

​

Troubleshooting

• 401/403: token is invalid or missing scopes.
• 400: wrong or missing locationId.
• No tool responses in stdio clients: use the HoopAI proxy path.
• Wrong location data: explicitly set HOOPAI_LOCATION_ID.