Skip to main content
POST
Create a tool kit

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.

Body

application/json

A new tool kit.

name
string
required

Name you give the tool kit, up to 256 characters.

Maximum string length: 256
Example:

"Support agent"

tools
object[]
required

Tools selected from registered servers or built-in integrations.

Required array length: 1 - 10000 elements
connection_policy
enum<string>

ALLOW_PARTIAL, the default and only supported policy, lists the kit's tools, including those of servers the caller has not connected when their definitions are known; calling one asks the caller to connect it.

Available options:
ALLOW_PARTIAL
description
string

What the tool kit is for, up to 4096 characters.

Maximum string length: 4096
Example:

"Linear and Notion tools for the support agent"

scope
enum<string>

workspace, the default, is visible to the whole workspace and links only workspace servers and built-ins. personal is visible only to the caller and may also link the caller's personal servers. Scope cannot change after creation.

Available options:
personal,
workspace

Response

Created

A tool kit: selected tools from one or more servers, exposed through one MCP endpoint.

connection_policy
enum<string>

ALLOW_PARTIAL lists the kit's tools, including those of servers the caller has not connected when their definitions are known; calling one asks the caller to connect it.

Available options:
ALLOW_PARTIAL
created_at
string

When the tool kit was created.

created_by
string<uuid> | null

LangSmith user who created the tool kit.

description
string

What the tool kit is for.

id
string<uuid>

Tool kit ID.

mcp_path
string

Streamable HTTP endpoint for this tool kit.

name
string

Tool kit name.

Example:

"Support agent"

scope
enum<string>

Who can see the tool kit: the whole workspace, or only its owner.

Available options:
personal,
workspace
server_count
integer

Number of MCP servers and built-ins the selected tools come from.

tool_count
integer

Number of selected tools.

tools
object[]

Selected tools. Omitted from list responses.

updated_at
string

When the tool kit last changed.

updated_by
string<uuid> | null

LangSmith user who last changed the tool kit.