HHH MCP
Connect Harry's HubSpot knowledge base to any MCP-compatible app.
What is HHH MCP?
HHH MCP (Triple-H MCP) turns Hub Helper Harry into an MCP server. Any app that speaks the Model Context Protocol can use Harry's HubSpot knowledge base, web search, and document retrieval.
Available on all paid plans. View plans
Quick Start
1. Choose your auth method
OAuth 2.0 (recommended): If your MCP client supports OAuth, it can authenticate directly via Clerk. No API key needed. The client will discover the endpoints automatically.
API key:For clients that don't support OAuth yet, create a connector key and pass it as a Bearer token.
2. Create a connector key (API key path only)
Go to Settings > MCP Connector and create a new key. Copy it immediately - it is only shown once.
3. Connect your client
Point your MCP client at Harry's server URL.
https://www.hubhelperharry.com/api/mcp/mcp
OAuth 2.0
MCP clients that support OAuth 2.0 (such as Claude Desktop) can connect without an API key. The client will automatically discover the authorization server via the well-known endpoints.
GET https://www.hubhelperharry.com/.well-known/oauth-authorization-server
GET https://www.hubhelperharry.com/.well-known/oauth-protected-resource
Supported scopes: profile, email.
Claude Desktop
Claude Desktop supports OAuth natively. If you prefer API keys, add this to your config file:
{
"mcpServers": {
"hub-helper-harry": {
"url": "https://www.hubhelperharry.com/api/mcp/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Replace YOUR_API_KEY with your actual key. Restart Claude Desktop after saving.
Cursor
Add this to your Cursor MCP settings:
{
"mcpServers": {
"hub-helper-harry": {
"url": "https://www.hubhelperharry.com/api/mcp/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Claude Code
Add Harry as an MCP server from PowerShell:
claude mcp add --transport http --scope user hub-helper-harry https://www.hubhelperharry.com/api/mcp/mcp --header "Authorization: Bearer YOUR_API_KEY"
If you are replacing an older setup, remove it first with claude mcp remove hub-helper-harry.
Other MCP Clients
Any MCP client that supports Streamable HTTP can connect to Harry. Use these values:
Server URL: https://www.hubhelperharry.com/api/mcp/mcp Authorization: Bearer YOUR_API_KEY
If your client supports OAuth 2.0, use the well-known endpoints above instead of an API key.
Available Tools
search_knowledgeSearch Harry's HubSpot knowledge base using semantic similarity.
query(string, required)The search querycategory(string)Filter: api-reference, developer-guide, general, knowledge-basetopic(string)Filter: crm, marketing, sales, cms, integrations, automation, analyticslimit(number)Results to return (default 20, max 30)get_documentRetrieve the full content of a knowledge base document by ID.
document_id(string, required)The UUID of the documentsearch_webSearch official HubSpot web domains for current information.
query(string, required)Search query (max 400 chars, use keywords)search_depth(string)basic or advanced (default: advanced)fetch_hubspot_urlFetch and extract content from a specific HubSpot URL.
url(string, required)Full HTTPS URL from a HubSpot domainask_harryAsk Harry a HubSpot question. Returns a knowledge-base-backed answer.
question(string, required)Your question in natural languageAvailable Resources
harry://knowledge/documentsList all documents in the knowledge base (metadata only).
harry://account/usageYour current month's usage stats and remaining quota.
Usage & Limits
- MCP tool calls are billed in batches: every 10 tool calls counts as 1 message against your monthly quota. The first MCP call of each month also counts as 1.
- MCP calls and chat messages share the same quota pool.
- Rate limit: 20 requests per minute per API key.
- Maximum 5 active API keys per account.
Authentication
All requests require a valid API key passed as a Bearer token in the Authorization header.
Authorization: Bearer hhh_live_your_key_here
API keys start with hhh_live_. Create and manage keys at Settings > MCP Connector.
Troubleshooting
“Failed” or “not authenticated” in your MCP client
Usually a wrong URL or expired API key. Remove the old server and re-add it:
claude mcp remove hub-helper-harry
claude mcp add --transport http --scope user hub-helper-harry https://www.hubhelperharry.com/api/mcp/mcp --header "Authorization: Bearer YOUR_API_KEY"
“HTTP 404” or HTML in error response
The URL is wrong. Make sure it ends in /api/mcp/mcp - not /api/mcp/http. This app uses mcp-handler, which exposes the streamable HTTP endpoint at /mcp.
“Unauthorized” or “Invalid API key”
Your key may have been revoked or mistyped. Create a new one at Settings > MCP Connector and update the key in your config.
Removing Harry from a client config
Open your client's config file, delete the hub-helper-harry entry, save, and restart the app.
Removing Harry from Claude Code or similar CLI clients
claude mcp remove hub-helper-harry
Questions? Ask Harry.