Skip to main content
Get your AI assistant connected to HoopAI in under 5 minutes.

​
Step 1: Get a Private Integration Token

Go to Settings → Integrations → Private Integrations in your HoopAI account. Click Create New Integration, select the required scopes for the tools you want to use, and copy the generated token.
For full access to all 36 MCP tools, see the complete scope list. For a quick start, enable View Contacts, View Conversations, and View Locations to test basic queries first.

​
Step 2: Configure your client

Add the MCP endpoint and your token to your agent configuration. The locationId in the header is optional — you can also pass it in prompts. 
{
  "mcpServers": {
    "hoopai-mcp": {
      "url": "https://services.leadconnectorhq.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "locationId": "YOUR_LOCATION_ID"
      }
    }
  }
}

​
Step 3: Test with a prompt

Once connected, try these prompts to verify everything is working: 
Show me my last 10 contacts

Find all unread conversations and summarize them

What calendar events do I have tomorrow?

Search opportunities in my pipeline

​
Using locationId dynamically

The MCP server supports two patterns for passing your Location ID: Option A — Header (recommended for single-account use): 
"headers": {
  "Authorization": "Bearer YOUR_API_KEY",
  "locationId": "YOUR_LOCATION_ID"
}
Option B — System prompt (useful for multi-account setups): 
The location id is YOUR_LOCATION_ID

​
Troubleshooting

ErrorCauseFix
401 UnauthorizedInvalid or expired tokenRe-generate your Private Integration Token
403 ForbiddenMissing scopeAdd the required scope in Private Integrations settings
400 Bad RequestMissing or wrong locationIdPass locationId in headers or prompt
No tool responsesClient doesn’t support HTTP StreamableUse the npx proxy package (coming soon)
Last modified on March 7, 2026