unpage mcp

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

Usage

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

Commands

Command	Description
`start`	Start the Unpage MCP Server
`tools`	List and call MCP tools available from enabled plugins
`client`	Debugging 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

Option	Description
`--profile TEXT`	Use profiles to manage multiple graphs [env var: UNPAGE_PROFILE] [default: default]
`--disable-stdio`	Disable the stdio transport for the MCP Server
`--disable-http`	Disable the HTTP transport for the MCP Server
`--disable-sse`	Disable the HTTP transport for the MCP Server (deprecated, use —disable-http instead)
`--http-host TEXT`	The host to bind the HTTP transport to [default: 127.0.0.1]
`--http-port INTEGER`	The port to bind the HTTP transport to [default: 8000]
`-h, --help`	Show 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

Command	Description
`list`	List all MCP tools available from enabled plugins
`call`	Call 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

Option	Description
`--profile TEXT`	Use profiles to manage multiple graphs [env var: UNPAGE_PROFILE] [default: default]
`-h, --help`	Show 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]

Options

Option	Description
`--profile TEXT`	Use profiles to manage multiple graphs [env var: UNPAGE_PROFILE] [default: default]
`--count-results`, `-c`	Count the number of results returned by the tool instead of printing the results
`--count-level INTEGER`	Count level for nested structures [min: 0, max: 1]
`-h, --help`	Show help message and exit

Examples

# Call a tool with arguments
unpage mcp tools call aws_list_ec2_instances --region us-west-2
unpage mcp tools call solarwinds_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

Command	Description
`logs`	Show 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

Command	Description
`claude`	Show 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

About Unpage

Core Concepts

Example Agents

Plugins

How-To Guides

Command Reference

Usage

Commands

Subcommand: start

Usage

Options

Transport Protocols

Examples

Default Start

HTTP Only

Custom HTTP Configuration

Using a Named Profile

Subcommand: tools

Usage

Commands

Subcommand: tools list

Usage

Options

Examples

Subcommand: tools call

Usage

Options

Examples

Subcommand: client

Usage

Commands

Subcommand: client logs

Usage

Commands

Subcommand: client logs claude

Usage

Examples

​Usage

​Commands

​Subcommand: start

​Usage

​Options

​Transport Protocols

​Examples

​Default Start

​HTTP Only

​Custom HTTP Configuration

​Using a Named Profile

​Subcommand: tools

​Usage

​Commands

​Subcommand: tools list

​Usage

​Options

​Examples

​Subcommand: tools call

​Usage

​Options

​Examples

​Subcommand: client

​Usage

​Commands

​Subcommand: client logs

​Usage

​Commands

​Subcommand: client logs claude

​Usage

​Examples

Usage

Commands

Subcommand: start

Usage

Options

Transport Protocols

Examples

Default Start

HTTP Only

Custom HTTP Configuration

Using a Named Profile

Subcommand: tools

Usage

Commands

Subcommand: tools list

Usage

Options

Examples

Subcommand: tools call

Usage

Options

Examples

Subcommand: client

Usage

Commands

Subcommand: client logs

Usage

Commands

Subcommand: client logs claude

Usage

Examples