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

# Verify the installation

> Make sure that the Handshake service runs and that your agents can use its MCP tools.

Use this procedure after you install or update Handshake.

## Prerequisites

* You installed Handshake.
* You ran `handshake setup`.

## Verify Handshake

<Steps>
  <Step title="Check the installed version">
    Run:

    ```bash theme={null}
    handshake version
    ```

    The command prints the installed Handshake version.
  </Step>

  <Step title="Check the service">
    Run:

    ```bash theme={null}
    curl http://localhost:8765/health
    ```

    The response is:

    ```text theme={null}
    ok
    ```

    If you configured a different port, use that port in the command.
  </Step>

  <Step title="List sessions from an agent">
    Open a connected agent. Enter:

    ```text theme={null}
    list my sessions
    ```

    The agent calls the `list_sessions` MCP tool. The result contains session
    titles, agent names, update times, directories, project names, and session
    IDs.
  </Step>
</Steps>

<Check>
  The installation is correct when the service returns `ok` and the agent can
  call `list_sessions`.
</Check>

If a check fails, use the [troubleshooting reference](/reference/troubleshooting).