Skip to content
Letta Platform Letta Platform Letta Docs
Sign up

Tools

List Tools For Mcp Server
GET/v1/mcp-servers/{mcp_server_id}/tools
Retrieve Mcp Tool
GET/v1/mcp-servers/{mcp_server_id}/tools/{tool_id}
Run Mcp Tool
POST/v1/mcp-servers/{mcp_server_id}/tools/{tool_id}/run
ModelsExpand Collapse
ToolListResponse = array of Tool { id, args_json_schema, created_by_id, 15 more }
id: string

The human-friendly ID of the Tool

args_json_schema: optional map[unknown]

The args JSON schema of the function.

created_by_id: optional string

The id of the user that made this Tool.

default_requires_approval: optional boolean

Default value for whether or not executing this tool requires approval.

description: optional string

The description of the tool.

enable_parallel_execution: optional boolean

If set to True, then this tool will potentially be executed concurrently with other tools. Default False.

json_schema: optional map[unknown]

The JSON schema of the function.

last_updated_by_id: optional string

The id of the user that made this Tool.

metadata_: optional map[unknown]

A dictionary of additional metadata for the tool.

name: optional string

The name of the function.

npm_requirements: optional array of NpmRequirement { name, version }

Optional list of npm packages required by this tool.

name: string

Name of the npm package.

minLength1
version: optional string

Optional version of the package, following semantic versioning.

pip_requirements: optional array of PipRequirement { name, version }

Optional list of pip packages required by this tool.

name: string

Name of the pip package.

minLength1
version: optional string

Optional version of the package, following semantic versioning.

project_id: optional string

The project id of the tool.

return_char_limit: optional number

The maximum number of characters in the response.

maximum1000000
minimum1
source_code: optional string

The source code of the function.

source_type: optional string

The type of the source code.

tags: optional array of string

Metadata tags.

tool_type: optional ToolType

The type of the tool.

One of the following:
"custom"
"letta_core"
"letta_memory_core"
"letta_multi_agent_core"
"letta_sleeptime_core"
"letta_voice_sleeptime_core"
"letta_builtin"
"letta_files_core"
"external_langchain"
"external_composio"
"external_mcp"