# Create Tool

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Create Tool"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/api/v2/workspaces/{workspace_id}/tools"}
  context={"endpoint"}
>
  
</MethodEndpoint>

Create a new tool.

This unified endpoint handles creation for all tool types
(MCP server tools and pipeline tools).

For MCP server tools, provide mcp_server data with URL, transport type, and
optional secret ID. For pipeline tools, provide pipeline data with pipeline ID
and optional input/output mappings.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails
  {...require("./create-tool-api-v-2-workspaces-workspace-id-tools-post.ParamsDetails.json")}
>
  
</ParamsDetails>

<RequestSchema
  {...require("./create-tool-api-v-2-workspaces-workspace-id-tools-post.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./create-tool-api-v-2-workspaces-workspace-id-tools-post.StatusCodes.json")}
>
  
</StatusCodes>