Tools

List Tools For Mcp Server

client.mcpServers.tools.list(, ?): ToolListResponse { id, args_json_schema, created_by_id, 15 more }

GET/v1/mcp-servers/{mcp_server_id}/tools

Retrieve Mcp Tool

client.mcpServers.tools.retrieve(, , ?): Tool { id, args_json_schema, created_by_id, 15 more }

GET/v1/mcp-servers/{mcp_server_id}/tools/{tool_id}

Run Mcp Tool

client.mcpServers.tools.run(, , ?): ToolExecutionResult { status, agent_state, func_return, 3 more }

POST/v1/mcp-servers/{mcp_server_id}/tools/{tool_id}/run

ModelsExpand Collapse

ToolListResponse = Array<Tool { id, args_json_schema, created_by_id, 15 more } >

id: string

The human-friendly ID of the Tool

args_json_schema?: Record<string, unknown> | null

The args JSON schema of the function.

created_by_id?: string | null

The id of the user that made this Tool.

default_requires_approval?: boolean | null

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

description?: string | null

The description of the tool.

enable_parallel_execution?: boolean | null

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

json_schema?: Record<string, unknown> | null

The JSON schema of the function.

last_updated_by_id?: string | null

The id of the user that made this Tool.

metadata_?: Record<string, unknown> | null

A dictionary of additional metadata for the tool.

name?: string | null

The name of the function.

npm_requirements?: Array<NpmRequirement { name, version } > | null

Optional list of npm packages required by this tool.

name: string

Name of the npm package.

minLength1

version?: string | null

Optional version of the package, following semantic versioning.

pip_requirements?: Array<PipRequirement { name, version } > | null

Optional list of pip packages required by this tool.

name: string

Name of the pip package.

minLength1

version?: string | null

Optional version of the package, following semantic versioning.

project_id?: string | null

The project id of the tool.

return_char_limit?: number

The maximum number of characters in the response.

maximum1000000

minimum1

source_code?: string | null

The source code of the function.

source_type?: string | null

The type of the source code.

tags?: Array<string>

Metadata tags.

tool_type?: 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"