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

# MCP inspector

MCP inspector is an open-source browser-based tool for testing MCP servers interactively. It lets you connect to Cotality MCP, discover your available tools, and execute tool calls — all without writing any code.

<Warning>
  While MCP inspector is one of the most widely adopted tools for MCP server testing and debugging, it is a third-party open-source project not maintained by Cotality. It is intended solely for local development and testing purposes and should not be used in production environments.
</Warning>

***

## Setup

### Prerequisites

MCP inspector runs on **Node.js**. If you don't already have it installed:

1. Download the latest **LTS** (Long-Term Support) version of Node.js
2. Run the installer and follow the on-screen prompts — the default settings are fine
3. Open a terminal (macOS: **Terminal**, Windows: **Command Prompt** or **PowerShell**) and verify the installation:

   ```bash theme={null}
   node --version
   ```

   You should see a version number (e.g., `v22.x.x`). This confirms that Node.js — and its bundled tools `npm` and `npx` — are ready to use.

### Launch MCP inspector

Run the following command in your terminal:

```bash theme={null}
npx @modelcontextprotocol/inspector
```

If prompted to install the package, type `y` and press **Enter** to confirm.

The inspector should automatically open in your default web browser. If it doesn't, check your terminal for the displayed URLs and open the one that includes the authentication token — this will take you directly to the Inspector UI with the connection pre-configured.

***

## Connect to Cotality MCP

1. In the inspector UI, set the **Transport type** to **Streamable HTTP**.

2. Enter the Cotality MCP endpoint URL for your target environment:

   | Environment    | URL                                |
   | -------------- | ---------------------------------- |
   | **UAT**        | `https://mcp-uat.cotality.com/mcp` |
   | **Production** | `https://mcp.cotality.com/mcp`     |

3. Click the **Authentication** tab in the left sidebar and configure the following:

   * **Header name** — `Authorization`
   * **Header value** — `Bearer <your_token>`

   Replace `<your_token>` with your OAuth2 access token. See [Authentication](../mcp/authentication) for how to obtain one.

4. Click **Connect**.

***

## Discover tools

Once connected, go to the **Tools** tab and click **List tools**. The inspector displays all tools available to you, including their names and descriptions. To see the detailed input/output schemas that an agent receives upon connecting, expand the `tools/list` call in the **History** section of the UI.

***

## Execute a tool call

1. Select a tool from the list (e.g., `clip-find_property_by_full_address`).
2. Fill in the input parameters using the auto-generated form.
3. Click **Run tool**.
4. The response JSON is displayed in the results panel.

This is the fastest way to explore Cotality MCP's capabilities and verify that your credentials are working correctly.

<Tip>
  MCP inspector maintains a session log under **History** which is useful for understanding and debugging MCP request/response sequences.
</Tip>

***

## Troubleshooting

| Problem              | Solution                                                                                                                                                                                     |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Connection fails** | Verify your endpoint URL and that your access token hasn't expired. Request a new token if needed.                                                                                           |
| **401 Unauthorized** | Ensure the authorization header is populated using the prefix "Bearer" and that your token hasn't expired. Follow the [Authentication](../mcp/authentication) steps to obtain a fresh token. |

## Next steps

* [Connecting with MCP clients](../mcp/connect) — Set up VS Code or other clients
* [Python example](../mcp/python) — Programmatic integration