Test Mcp Server

Test connection to an MCP server without adding it. Returns the list of available tools if successful.

Request

This endpoint expects an object.

objectRequired

Response

Successful Response

namestring

inputSchemaobject

descriptionstring or null

annotationsobject or null

Additional properties describing a Tool to clients.

NOTE: all properties in ToolAnnotations are hints. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like title).

Clients should never make tool use decisions based on ToolAnnotations received from untrusted servers.

1	from letta_client import Letta, StdioServerConfig
2
3	client = Letta(
4	token="YOUR_TOKEN",
5	)
6	client.tools.test_mcp_server(
7	request=StdioServerConfig(
8	server_name="server_name",
9	command="command",
10	args=["args"],
11	),
12	)

1	[
2	{
3	"name": "foo",
4	"inputSchema": {},
5	"description": "foo",
6	"annotations": {
7	"title": "foo",
8	"readOnlyHint": true,
9	"destructiveHint": true,
10	"idempotentHint": true,
11	"openWorldHint": true
12	}
13	}
14	]

Headers

Request

Response