Tunnels auflisten

$client->beta->tunnels->list(?bool includeArchived, ?int limit, ?string page, ?list<AnthropicBeta> betas, ?string workspaceID): PageCursor<BetaTunnel>

GET/v1/tunnels

Requires anthropic-beta: mcp-tunnels-2026-06-22. How to send beta headers

Die Tunnels API befindet sich in der "Research Preview" (Forschungsvorschau). Sie erfordert den Header anthropic-beta: mcp-tunnels-2026-06-22 und kann sich ohne Abkündigungsfrist ändern. Sie ersetzt die Admin-API-Endpunkte unter /v1/organizations/tunnels, die während eines Migrationszeitraums weiterhin verfügbar bleiben.

Listet Tunnels auf. Die Ergebnisse sind nach Erstellungszeitpunkt sortiert, neueste zuerst; archivierte Tunnels werden ausgeschlossen, sofern include_archived nicht gesetzt ist.

Parameters

includeArchived?: optional bool⁠Query

Whether to include archived tunnels in the results. Defaults to false.

limit?: optional int⁠Query

Maximum number of tunnels to return per page. Defaults to 20, maximum 1000.

page?: optional string⁠Query

Opaque pagination cursor from a previous list_tunnels response.

betas?: optional list<AnthropicBeta>⁠Header

This endpoint is in beta: requests must send mcp-tunnels-2026-06-22 in this header.

workspaceID?: optional string⁠Header

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns

class BetaTunnel { $type = 'tunnel'; $id; $archivedAt; /* 3 more */ }

"tunnel" type

string id

Unique identifier for the tunnel, prefixed with tnl_.

?\Datetime archivedAt

RFC 3339 datetime string indicating when the tunnel was archived. Null if it is not archived.

\Datetime createdAt

RFC 3339 datetime string indicating when the tunnel was created.

?string displayName

Human-readable name for the tunnel (1-255 characters). Null if unset.

string domain

Anthropic-assigned hostname for the tunnel. MCP server URLs whose host is a subdomain of this value are routed through the tunnel. Globally unique and never reused, even after the tunnel is archived.

Tunnels auflisten

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\AnthropicBeta;

$client = new Client(apiKey: 'my-anthropic-api-key');

$page = $client->beta->tunnels->list(
  includeArchived: true,
  limit: 0,
  page: 'page',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
  workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy',
);

var_dump($page);

Response 200

{
  "data": [
    {
      "id": "id",
      "archived_at": "2019-12-27T18:11:19.117Z",
      "created_at": "2019-12-27T18:11:19.117Z",
      "display_name": "display_name",
      "domain": "domain",
      "type": "tunnel"
    }
  ],
  "next_page": "next_page"
}

Returns Examples

Response 200

{
  "data": [
    {
      "id": "id",
      "archived_at": "2019-12-27T18:11:19.117Z",
      "created_at": "2019-12-27T18:11:19.117Z",
      "display_name": "display_name",
      "domain": "domain",
      "type": "tunnel"
    }
  ],
  "next_page": "next_page"
}