loco-admin-web/specs/designs/12-tools/form.md

Tool Form Page

Overview

Shared <ToolForm> handles both create and edit. The mode toggle (External vs Managed) is chosen at the top in create mode and is locked in edit mode.

Follows the form layout in specs/designs/10-layout/form.md, only the details are documented in this spec.

Form Layout

External

Basic Information → Endpoint

Managed

Basic Information → Deployment

Panels

Basic Information (shared)

Beyond the standard Icon + Name + Mode fields described in the layout spec:

• Icon: default tool
• Description: textarea, 3 rows, placeholder What does this tool do?; help: "Provide a brief description that can also help AI assistant to understand the tool's functionality."
• Tags: optional list input

Endpoint (external only)

• URL: text, placeholder e.g. https://my-tool.internal/mcp
• Transport: Streamable HTTP | Server-side Events
• Auth Type: None | Bearer Token | API Key; default None
• When auth type is Bearer Token:
  • Bearer Token: password input
• When auth type is API Key:
  • API Key Header: text, placeholder e.g. X-Api-Key
  • API Key Value: password input

Deployment (managed only)

• Transport: Streamable HTTP | Server-side Events
• Launch Command: single command input (runtime inferred from command prefix)
• Runtime Settings: optional deployment/runtime configuration

Validation

• Name is required

Breadcrumb

• Create: Tools / [New Tool]
• Edit: Tools / {tool.name}