Skip to main content
GET
List MCP servers

Authorizations

X-Api-Key
string
header
required

Personal or workspace LangSmith API key. Personal keys identify the user. Workspace keys are limited to server listing and MCP calls and must also supply the end user's OIDC token or X-LangSmith-Identity.

X-Tenant-Id
string
header
required

Workspace UUID. This header selects a workspace; it does not authenticate the caller.

Headers

X-LangSmith-Identity
string

Advanced alternative to a user OIDC token with a workspace API key. Set to the user's Tool Gateway identity UUID or provider:subject. Ignored for personal credentials.

X-LangSmith-Profile
string<uuid>

Profile ID whose connection status to show. Accepts workspaces:credentials:read-metadata, workspaces:credentials:use, agent-auth-credentials:use, or legacy workspaces:manage. This reads metadata only and does not grant runtime credential use. Cannot be combined with X-LangSmith-Identity or a user OIDC token.

Query Parameters

page_size
integer
default:20

Items per page

Required range: 1 <= x <= 100
cursor
string

Opaque pagination cursor

owned_by
enum<string>

any lists only the personal servers of every workspace member, with owned_by set and without upstream URLs, connection fields, or credential status. Requires workspaces:integrations:read or workspaces:manage.

Available options:
any
credential_owner_type
enum<string>

Owner whose credential to show connection status for instead of the caller's. Requires a user credential; tool calls cannot name an owner.

Available options:
agent_identity,
workspace
credential_owner_id
string<uuid>

Agent environment ID, from GET /api/v1/agents/{agent_id}, or the workspace ID for workspace. Sent with credential_owner_type.

Response

OK

A page of the MCP servers and built-ins you can use.

items
object[]

MCP servers and built-ins on this page.

next_cursor
string | null

Cursor for the next page. Null on the last page.