The mcp command group provides functionality to start the MCP (Model Coupling Protocol) Server and interact with the tools exposed by plugins.

​
Usage

unpage mcp [OPTIONS] COMMAND [ARGS]...

​
Commands

CommandDescription
startStart the Unpage MCP Server
toolsList and call MCP tools available from enabled plugins
clientDebugging tools for clients of the Unpage MCP Server

​
Subcommand: start

The start command launches the Unpage MCP Server, which allows LLM-powered applications to interact with your infrastructure through a set of tools exposed by plugins.

​
Usage

unpage mcp start [OPTIONS]

​
Options

OptionDescription
--profile TEXTUse profiles to manage multiple graphs [env var: UNPAGE_PROFILE] [default: default]
--disable-stdioDisable the stdio transport for the MCP Server
--disable-httpDisable the HTTP transport for the MCP Server
--disable-sseDisable the HTTP transport for the MCP Server (deprecated, use —disable-http instead)
--http-host TEXTThe host to bind the HTTP transport to [default: 127.0.0.1]
--http-port INTEGERThe port to bind the HTTP transport to [default: 8000]
-h, --helpShow help message and exit

​
Transport Protocols

The MCP Server supports two transport protocols:
  • HTTP Transport: Enables connection through HTTP, useful for web applications and remote clients
  • stdio Transport: Enables communication through standard input/output, useful for direct integration with CLI tools

​
Examples

​
Default Start

Start the MCP Server with both stdio and HTTP transport: 
unpage mcp start

​
HTTP Only

Start the MCP Server with only HTTP transport: 
unpage mcp start --disable-stdio

​
Custom HTTP Configuration

Start the MCP Server on a specific host and port: 
unpage mcp start --http-host 0.0.0.0 --http-port 9000

​
Using a Named Profile

Start the MCP Server with a specific configuration profile: 
unpage mcp start --profile production

​
Subcommand: tools

The tools command provides functionality to list and manually invoke tools that are made available by plugins to the MCP server.

​
Usage

unpage mcp tools [OPTIONS] COMMAND [ARGS]...

​
Commands

CommandDescription
listList all MCP tools available from enabled plugins
callCall an MCP tool from the command line

​
Subcommand: tools list

Lists all MCP tools that are available from the currently enabled plugins.

​
Usage

unpage mcp tools list [OPTIONS]

​
Options

OptionDescription
--profile TEXTUse profiles to manage multiple graphs [env var: UNPAGE_PROFILE] [default: default]
-h, --helpShow help message and exit

​
Examples

# List all available tools
unpage mcp tools list

# List tools for a specific profile
unpage mcp tools list --profile production

​
Subcommand: tools call

Calls an MCP tool directly from the command line, allowing you to test and use tools without going through an LLM.

​
Usage

unpage mcp tools call [OPTIONS] TOOL_NAME [ARGS]

​
Examples

# Call a tool with arguments
unpage mcp tools call aws_list_ec2_instances --region us-west-2
unpage mcp tools call papertrail_search_logs error "2025-07-25T00:00:00+00:00" "2025-07-27T00:00:00+00:00"

# Call a tool and pipe output to jq for processing
unpage mcp tools call datadog_get_metrics | jq .

​
Subcommand: client

The client command provides debugging tools for clients of the Unpage MCP Server.

​
Usage

unpage mcp client [OPTIONS] COMMAND [ARGS]...

​
Commands

CommandDescription
logsShow logs for a client of the Unpage MCP Server

​
Subcommand: client logs

Show logs for a client of the Unpage MCP Server, like Claude Desktop.

​
Usage

unpage mcp client logs [OPTIONS] COMMAND [ARGS]...

​
Commands

CommandDescription
claudeShow logs for Claude Desktop Unpage MCP Server

​
Subcommand: client logs claude

Shows the location of log files for Claude Desktop’s Unpage MCP Server integration.

​
Usage

unpage mcp client logs claude

​
Examples

# Show Claude Desktop log file locations
unpage mcp client logs claude