MCP Server (Beta)

Updated on April 8, 2026

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 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...\"]"
    }
  ]
}