MCP Server Quick Start¶

Owl MCP Server is a server-side implementation provided by TrueWatch based on the Model Context Protocol. It encapsulates TrueWatch's capabilities such as Metrics, Logs, Events, Monitors, Dashboards, APM, RUM, and Infrastructure into MCP tools for use by AI clients that support MCP.

This document explains how to connect to Owl MCP Server via streamableHttp.

Prerequisites¶

Before connecting, please ensure the following preparations are complete:

You have created a TrueWatch API Key with the corresponding business permissions.
You have obtained the Owl MCP Endpoint corresponding to the site where your workspace belongs.
The Owl MCP service connection configuration has been completed in your MCP client.
The current network environment can access the Owl MCP Endpoint.

Endpoint¶

Owl MCP Server provides independent Endpoints by site. Please select the address corresponding to the site where your workspace belongs.

Deployment Type	Site Name	Endpoint
SaaS Deployment	Overseas Region 1 (Oregon)	`https://us1-owl-mcp.truewatch.com/mcp`
SaaS Deployment	Europe Region 1 (Frankfurt)	`https://eu1-owl-mcp.truewatch.com/mcp`
SaaS Deployment	Asia Pacific Region 1 (Singapore)	`https://ap1-owl-mcp.truewatch.com/mcp`
SaaS Deployment	Africa Region 1 (South Africa)	`https://za1-owl-mcp.truewatch.com/mcp`
SaaS Deployment	Indonesia Region 1 (Jakarta)	`https://id1-owl-mcp.truewatch.com/mcp`
SaaS Deployment	Middle East Region 1 (UAE)	`https://me1-owl-mcp.truewatch.com/mcp`

Authentication Method¶

Configure the request header in your MCP client:

Authorization: Bearer <API Key>

Where <API Key> is your TrueWatch API Key. Please keep it secure and do not include it in public code repositories, shared documents, or long-term logs.

Client Configuration¶

Owl MCP Server uses the standard streamableHttp connection method and can be connected to MCP clients that support this transport method. The configuration entry and field names may vary slightly between different clients. Please refer to the actual client documentation.

The following examples use Cherry Studio, OpenClaw, and Hermes to illustrate the configuration for common MCP clients. Other MCP clients that support streamableHttp can be configured similarly:

URL: Fill in the Owl MCP Endpoint corresponding to your workspace's site.
Request Header: Configure Authorization: Bearer <API Key>.
Enable this MCP service.

The following examples use the placeholder address your-owl-mcp-endpoint. When actually connecting, replace it with the Owl MCP Endpoint corresponding to your workspace's site.

Cherry Studio¶

Add a new MCP service in Cherry Studio and configure it as follows:

Type: streamableHttp
URL: your-owl-mcp-endpoint
Request Headers: Authorization=Bearer <API Key>

After configuration, save and enable it, then return to the client homepage to select this MCP service.

OpenClaw¶

openclaw mcp set owl '{
  "type": "streamableHttp",
  "url": "your-owl-mcp-endpoint",
  "headers": {
    "Authorization": "Bearer <API Key>"
  },
  "enabled": true
}'

Verify the configuration:

openclaw mcp list
openclaw mcp show owl

Hermes¶

Edit ~/.hermes/config.yaml:

mcp_servers:
  owl:
    type: streamableHttp
    url: your-owl-mcp-endpoint
    headers:
      Authorization: Bearer <API Key>
    enabled: true

Verify the configuration:

hermes mcp list
hermes mcp test owl

Usage Conventions¶

When using Owl MCP Server, it is recommended to follow these conventions:

Type	Convention
Time Range Tools	Use 13-digit millisecond timestamps uniformly.
Pagination Tools	Typically support `page_size` and `page_index`.
Detail Tools	Usually rely on identifier fields returned by list tools, such as `dashboard_uuid`, `rule_uuid`, `incident_uuid`, `issue_id`.
Data Query Tools	It is recommended to use them in the order of "discover first, then query". First, use discovery tools to obtain available `source`, `field`, `index`, then perform the formal query.

Verification Method¶

After configuration is complete, you can ask in your MCP client:

List the available metric sources.

The client should be able to discover and call owl.metric.list. If connection fails, authentication fails, the tool list is empty, or results are empty, please refer to Troubleshooting.