> For the complete documentation index, see [llms.txt](https://docs.bluerock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bluerock.io/getting-started-with-bluerock/quick-start.md).

# Quick Start

Access the BlueRock Secure MCP Server on AWS using the Full BlueRock AMI. This environment establishes a secure baseline for executing applications within the BlueRock Sandbox. Unlike the Free tier, the Full deployment supports custom security configurations via the TREX tool, enabling notifications of active attack and inline blocking. The Full AMI comes preloaded with a working Weather Forecast MCP server to help establish a secure connection and test functionality immediately.

Follow these steps to access the environment and execute the example process:

1. [Connect to the BlueRock Instance](https://www.google.com/search?q=%23connect-to-the-bluerock-instance)
2. [Launch the Weather MCP Server](https://www.google.com/search?q=%23launch-the-weather-mcp-server)
3. [Connect the Weather MCP Client](https://www.google.com/search?q=%23connect-the-weather-mcp-client)
4. [Test the Weather MCP](https://www.google.com/search?q=%23test-the-weather-mcp)

***

### Connect to the BlueRock Instance

With the AWS EC2 instance running the Full BlueRock AMI, establish a connection to access the environment.

Log in using the default `ec2-user` username and the SSH key specified during the instance launch:

```shellscript
ssh -i </path/to/key>.pem ec2-user@<INSTANCE_PUBLIC_IP>
```

### Launch the Weather MCP Server

Once logged in, the BlueRock Sandbox binary is pre-installed at `/opt/bluerock/bin/brace`. In the Full tier, the Sandbox actively enforces custom security policies defined through the TREX policy manager to provide inline blocking against unauthorized actions.

Navigate to the preloaded Weather MCP directory, activate the Python virtual environment, and use the sandbox to launch the server:

```shellscript
cd /opt/bluerock/mcp/weatherMCP
source .venv/bin/activate

# Launch the server securely inside the BlueRock Sandbox
/opt/bluerock/bin/brace -l server.log -- uv run server-weatherMCP.py
```

* `-l`: Specifies the path to create the local log file for sandbox execution data.
* `--`: Separates the sandbox configurations from the target application's execution command.

### Connect the Weather MCP Client

Open a new, separate terminal window on the local machine and log into the EC2 instance again using the same SSH command from the first step.

Once connected, navigate to the Weather MCP directory, activate the virtual environment, and start the interactive client:

```shellscript
cd /opt/bluerock/mcp/weatherMCP
source .venv/bin/activate

# Launch the interactive client
uv run client-weatherMCP.py
```

Upon successful connection, the console will display a `weather>` prompt and a list of available tools.

### Test the Weather MCP

With the interactive client running, execute commands to retrieve real-time weather data from the sandboxed server. For example, to fetch active weather alerts for California, enter the following at the prompt:

```shellscript
weather> alerts CA
```

Expected Output Snippet:

```shellscript
[10/31/25 15:49:46] INFO Processing request of type CallToolRequest server.py:674
============================================================
WEATHER ALERTS
============================================================
Event: Beach Hazards Statement
Area: San Francisco; Coastal North Bay Including Point Reyes National Seashore...
Severity: Moderate
Description: * WHAT...A long period northwesterly swell will result in an
increased risk for sneaker waves...
```

To view all available commands, type `help`. To exit the client, type `quit`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bluerock.io/getting-started-with-bluerock/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.