Agent Skills › letta-ai/letta-code › using-cloud-mcp

using-cloud-mcp

GitHub

指导Agent使用Letta Cloud MCP CLI工具，列出已连接的MCP服务器、查看工具列表并执行具体工具。涵盖从云沙箱到终端的多场景操作及错误处理规则。

src/skills/builtin/using-cloud-mcp/SKILL.md letta-ai/letta-code

Trigger Scenarios

用户询问如何使用已连接的MCP服务器用户要求列出Agent的MCP服务器或工具用户在聊天中运行MCP工具提及cloud MCP、server-side MCP、agent MCP或letta cloud-mcp

Install

npx skills add letta-ai/letta-code --skill using-cloud-mcp -g -y

More Options

Non-standard path

npx skills add https://github.com/letta-ai/letta-code/tree/main/src/skills/builtin/using-cloud-mcp -g -y

Use without installing

npx skills use letta-ai/letta-code@using-cloud-mcp

指定 Agent (Claude Code)

npx skills add letta-ai/letta-code --skill using-cloud-mcp -a claude-code -g -y

安装 repo 全部 skill

npx skills add letta-ai/letta-code --all -g -y

预览 repo 内 skill

npx skills add letta-ai/letta-code --list

SKILL.md

Frontmatter

{
    "name": "using-cloud-mcp",
    "description": "Uses MCP servers connected to the current Letta Cloud agent (cloud MCP). Load when the user asks to use a connected MCP server, list the agent's MCP servers or MCP tools, run an MCP tool connected in ADE\/chat, or mentions cloud MCP, server-side MCP, agent MCP, or `letta cloud-mcp`."
}

Using Cloud MCP

Letta Cloud stores MCP server connections per agent. The letta cloud-mcp CLI lists and runs those servers' tools through the Letta API, so it works from any surface where the agent runs: cloud sandboxes (chat.letta.com), Letta Desktop, and terminals.

Workflow

List MCP servers connected to this agent:

letta cloud-mcp list

Pick the relevant id from the JSON output, then list its tools:

letta cloud-mcp tools <mcp-server-id>

Pick a tool id, inspect its name and description, and run it with a JSON object:

letta cloud-mcp run <mcp-server-id> <tool-id> --args '{"key":"value"}'

Rules

Do not ask for an agent ID unless the user wants another agent. The CLI reads LETTA_AGENT_ID/AGENT_ID from the environment.
Treat command output as JSON. Summarize relevant results instead of pasting large raw payloads.
If list is empty, ask the user to connect an MCP server to the agent on the MCP servers page.
If tools is empty for a connected server, the server's tools were never synced. Ask the user to resync the server from the MCP servers page; the CLI has no refresh action.
If a connected server has type stdio, its tools cannot run on hosted Letta Cloud. Tell the user instead of retrying.
This requires a signed-in Letta Cloud agent. MCP servers configured locally in the terminal (/mcp) are unrelated to this CLI.