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

# Overview

> Connect TierZero as a remote MCP server to MCP-compliant clients such as Claude Code, Cursor, or any HTTP/OAuth-aware client.

## What it is

TierZero exposes a remote Model Context Protocol (MCP) server. AI coding assistants — Claude Code, Cursor, and any other MCP-compliant client — can call it directly to query your production context while you work.

* **Endpoint:** `https://api.tierzero.ai/mcp/`
* **Transport:** Streamable HTTP
* **Auth:** OAuth 2.1 (recommended) or Personal Access Token

## What it does

The server exposes two tools.

### `tierzero_ask`

Runs a TierZero investigation against your connected production systems and returns evidence-backed findings. It can:

* Query logs, metrics, traces, and spans from connected integrations such as Datadog, New Relic, CloudWatch, Grafana Cloud, and Sentry
* Inspect GitHub repositories, CI/CD systems such as BuildKite and GitHub Actions, and workflow orchestration in Temporal
* Retrieve documentation and runbooks from connected knowledge sources such as Confluence, Notion, and Slack
* Correlate findings across telemetry, code, workflows, and documentation

<img src="https://mintcdn.com/tierzeroaiinc/FeffdqnOGs6bHKNh/images/mcp-ask-tierzero.webp?fit=max&auto=format&n=FeffdqnOGs6bHKNh&q=85&s=8bf067f0ddbf441adfa4dc6c957cc265" alt="Claude Code automatically loading the TierZero skill and running a TierZero production context query in the background" className="rounded-lg shadow-lg my-6 border border-gray-800" width="1600" height="928" data-path="images/mcp-ask-tierzero.webp" />

<Warning>
  `tierzero_ask` invokes the TierZero agent, which may take several minutes for non-trivial queries. Clients that support MCP progress notifications will display progress updates during execution.
</Warning>

### `tierzero_fetch_context`

Loads an existing TierZero chat, investigation, digest, or artifact into your IDE so you can act on it without starting a new investigation.

<img src="https://mintcdn.com/tierzeroaiinc/FeffdqnOGs6bHKNh/images/mcp-fetch-context.webp?fit=max&auto=format&n=FeffdqnOGs6bHKNh&q=85&s=3cdefecdbbbb8d3cf951881864f2a673" alt="Claude Code fetching existing TierZero chat context and using it to answer a follow-up question" className="rounded-lg shadow-lg my-6 border border-gray-800" width="1800" height="379" data-path="images/mcp-fetch-context.webp" />

Arguments:

* `url`: A TierZero chat URL (`https://app.tierzero.ai/chat/c/<GlobalID>`), investigation URL (`https://app.tierzero.ai/investigations/<GlobalID>`), digest run URL (`https://app.tierzero.ai/digests/run/<GlobalID>`), or raw GlobalID
* `include_sources`: Optional boolean. Set to `true` to include source metadata in the response

## Choosing a client

Pick the setup guide that matches your client:

<CardGroup cols={3}>
  <Card title="Claude Code" icon="terminal" href="/references/mcp/claude-code">
    Plugin install + OAuth. Recommended for Claude Code users.
  </Card>

  <Card title="Cursor" icon="mouse-pointer-2" href="/references/mcp/cursor">
    Cursor marketplace install + OAuth.
  </Card>

  <Card title="Other MCP clients" icon="plug" href="/references/mcp/other">
    Any HTTP MCP client. OAuth 2.1 or PAT.
  </Card>
</CardGroup>

## Troubleshooting

### Authentication didn't pop up

Run `/mcp` in Claude Code, or open the MCP panel in Cursor settings, and click **Authenticate** on the `tierzero` server.

### Token expired or revoked

Reconnect from the same place: `/mcp` in Claude Code, or the Tools & MCP panel in Cursor. The client will start a fresh OAuth flow. If you're using a PAT, generate a new one at [auth.tierzero.ai/account/api\_keys/](https://auth.tierzero.ai/account/api_keys/) and update your client config.

### Connection issues

Confirm `https://api.tierzero.ai/mcp/` is reachable from your network and that your client supports HTTP transport. Older MCP clients that only support stdio transport are not compatible with the remote server.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.