Hugo exposes an MCP server that allows external AI agents and tools to access Hugo's capabilities.
This feature is currently in beta. The available tools and their definitions may change.
The Hugo MCP Server implements the Model Context Protocol standard, allowing any MCP-compatible client to connect and use Hugo's tools.
Available Tools
Currently, the following tool is available:
search
Search for information in the knowledge base.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | Yes | The search query |
sources |
array | No | Sources to search in. Defaults to all sources if not specified. Possible values: webpage, helpdesk, answer, document |
Example:
{
"name": "search",
"arguments": {
"query": "How do I reset my password?",
"sources": ["helpdesk", "answer"]
}
}
Connecting to the MCP Server
Endpoint
The MCP server is available at:
https://app.hugo.ai/api/mcp/
Authentication
All requests must include a valid website token in the Authorization header:
Authorization: Bearer YOUR_WEBSITE_TOKEN
Example with TypeScript
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = new Client({
name: "my-client",
version: "1.0.0"
});
await client.connect(new StreamableHTTPClientTransport(
new URL("https://app.hugo.ai/api/mcp/"),
{
requestInit: {
headers: {
"Authorization": "Bearer YOUR_WEBSITE_TOKEN"
}
}
}
));
// Call the search tool
const result = await client.callTool({
name: "search",
arguments: {
query: "pricing information"
}
});
console.log(result);
Response Format
Tool responses are returned as text content containing JSON:
{
"content": [
{
"type": "text",
"text": "[\"Result 1 text...\", \"Result 2 text...\"]"
}
]
}