> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unpage.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# unpage mcp

> MCP server commands for LLM interaction with infrastructure

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

## Usage

```shell theme={null}
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

```shell theme={null}
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:

```shell theme={null}
unpage mcp start
```

#### HTTP Only

Start the MCP Server with only HTTP transport:

```shell theme={null}
unpage mcp start --disable-stdio
```

#### Custom HTTP Configuration

Start the MCP Server on a specific host and port:

```shell theme={null}
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:

```shell theme={null}
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

```shell theme={null}
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

```shell theme={null}
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

```shell theme={null}
# 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

```shell theme={null}
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

```shell theme={null}
# 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

```shell theme={null}
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

```shell theme={null}
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

```shell theme={null}
unpage mcp client logs claude
```

#### Examples

```shell theme={null}
# Show Claude Desktop log file locations
unpage mcp client logs claude
```