Letta Agents MCP Server
오픈API-MCP-서버
Letta API를 위한 MCP(Model Context Protocol) 서버.
설명
이 서버는 API에 대한 MCP(Model Context Protocol) 인터페이스를 제공합니다.
Related MCP server: agentforge
설치
종속성 설치:
지엑스피1
.env.example기반으로.env파일을 만듭니다.
cp .env.example .env.env파일을 편집하여 API 구성 및 권한 부여 세부 정보를 추가합니다.
구성
다음 환경 변수는 .env 파일에서 구성할 수 있습니다.
API_BASE_URL: API의 기본 URL(필수)SERVER_NAME: MCP 서버의 이름(기본값: "openapi-mcp-server")SERVER_VERSION: MCP 서버의 버전(기본값: "1.0.0")DEBUG: 디버그 로깅 활성화(true/false)(기본값: false)
용법
서버 실행
서버는 JavaScript와 TypeScript 버전으로 제공됩니다.
# Run JavaScript version
npm start
# Or run TypeScript version (compiles on the fly)
npm run start:tsTypeScript 버전 빌드
npm run build
cd dist
node server.jsMCP 도구 공급자로 사용
이 서버는 MCP(Model Context Protocol)를 구현하며 Claude.js 클라이언트나 다른 MCP 소비자와 같은 모든 MCP 호환 소비자와 함께 사용할 수 있습니다.
Claude.js 클라이언트에서 이 서버에 연결하는 예:
import { MCP } from "claude-js";
import { createStdio } from "claude-js/mcp";
// Create stdin/stdout transport
const transport = createStdio({ command: "node path/to/server.js" });
// Connect to the MCP server
const mcp = new MCP({ transport });
await mcp.connect();
// List available tools
const { tools } = await mcp.listTools();
console.log("Available tools:", tools);
// Call a tool
const result = await mcp.callTool({
id: "TOOL-ID",
arguments: { param1: "value1" }
});
console.log("Tool result:", result);사용 가능한 도구
이 MCP 서버는 다음과 같은 도구를 제공합니다.
삭제_도구
ID :
DELETE-v1-tools-tool-id설명 : 이름으로 도구 삭제
방법 :
DELETE경로 :
/v1/tools/{tool_id}
매개변수 :
tool_id: tool_id 매개변수(필수)user_id: user_id 매개변수
검색 도구
ID :
GET-v1-tools-tool-id설명 : ID로 도구 가져오기
방법 :
GET경로 :
/v1/tools/{tool_id}
매개변수 :
tool_id: tool_id 매개변수(필수)user_id: user_id 매개변수
수정_도구
ID :
PATCH-v1-tools-tool-id설명 : 기존 도구 업데이트
방법 :
PATCH경로 :
/v1/tools/{tool_id}
매개변수 :
tool_id: tool_id 매개변수(필수)user_id: user_id 매개변수
목록 도구
ID :
GET-v1-tools-설명 : 사용자 조직에 속한 에이전트가 사용할 수 있는 모든 도구 목록을 가져옵니다.
방법 :
GET경로 :
/v1/tools/
매개변수 :
after: 매개변수 이후limit: 한계 매개변수name: 이름 매개변수user_id: user_id 매개변수
생성_도구
ID :
POST-v1-tools-설명 : 새로운 도구 만들기
방법 :
POST경로 :
/v1/tools/
매개변수 :
user_id: user_id 매개변수
업서트_툴
ID :
PUT-v1-tools-설명 : 도구 만들기 또는 업데이트
방법 :
PUT경로 :
/v1/tools/
매개변수 :
user_id: user_id 매개변수
add_base_tools
ID :
POST-v1-tools-add-base-tools설명 : 업서트 베이스 도구
방법 :
POST경로 :
/v1/tools/add-base-tools
매개변수 :
user_id: user_id 매개변수
소스에서 실행 도구
ID :
POST-v1-tools-run설명 : 소스에서 도구를 빌드한 다음 제공된 인수에 따라 실행합니다.
방법 :
POST경로 :
/v1/tools/run
매개변수 :
user_id: user_id 매개변수
목록_작성_앱
ID :
GET-v1-tools-composio-apps설명 : 모든 Composio 앱 목록을 가져옵니다.
방법 :
GET경로 :
/v1/tools/composio/apps
매개변수 :
user-id: 사용자 ID 매개변수
앱별_작성_작업_목록
ID :
GET-v1-tools-composio-apps-composio-app-name-actions설명 : 특정 앱에 대한 모든 Composio 작업 목록을 가져옵니다.
방법 :
GET경로 :
/v1/tools/composio/apps/{composio_app_name}/actions
매개변수 :
composio_app_name: composio_app_name 매개변수(필수)user_id: user_id 매개변수
add_composio_tool
ID :
POST-v1-tools-composio-composio-action-name설명 : 작업 이름으로 새로운 Composio 도구를 추가합니다(Composio는 각 도구를
Action이라고 함)방법 :
POST경로 :
/v1/tools/composio/{composio_action_name}
매개변수 :
composio_action_name: composio_action_name 매개변수(필수)user_id: user_id 매개변수
list_mcp_servers
ID :
GET-v1-tools-mcp-servers설명 : 구성된 모든 MCP 서버 목록을 가져옵니다.
방법 :
GET경로 :
/v1/tools/mcp/servers
매개변수 :
user-id: 사용자 ID 매개변수
add_mcp_server
ID :
PUT-v1-tools-mcp-servers설명 : Letta MCP 서버 구성에 새 MCP 서버 추가
방법 :
PUT경로 :
/v1/tools/mcp/servers
매개변수 :
user_id: user_id 매개변수
서버별 mcp 도구 목록
ID :
GET-v1-tools-mcp-servers-mcp-server-name-tools설명 : 특정 MCP 서버에 대한 모든 도구 목록을 가져옵니다.
방법 :
GET경로 :
/v1/tools/mcp/servers/{mcp_server_name}/tools
매개변수 :
mcp_server_name: mcp_server_name 매개변수(필수)user_id: user_id 매개변수
add_mcp_tool
ID :
POST-v1-tools-mcp-servers-mcp-server-name-mcp-tool-name설명 : MCP 서버 + 도구 이름으로 새로운 MCP 도구를 Letta 서버로 등록합니다.
방법 :
POST경로 :
/v1/tools/mcp/servers/{mcp_server_name}/{mcp_tool_name}
매개변수 :
mcp_server_name: mcp_server_name 매개변수(필수)mcp_tool_name: mcp_tool_name 매개변수(필수)user_id: user_id 매개변수
delete_mcp_server
ID :
DELETE-v1-tools-mcp-servers-mcp-server-name설명 : Letta MCP 서버 구성에 새 MCP 서버 추가
방법 :
DELETE경로 :
/v1/tools/mcp/servers/{mcp_server_name}
매개변수 :
mcp_server_name: mcp_server_name 매개변수(필수)user_id: user_id 매개변수
검색_소스
ID :
GET-v1-sources-source-id설명 : 모든 소스 가져오기
방법 :
GET경로 :
/v1/sources/{source_id}
매개변수 :
source_id: source_id 매개변수(필수)user_id: user_id 매개변수
수정_소스
ID :
PATCH-v1-sources-source-id설명 : 기존 데이터 소스의 이름이나 문서를 업데이트합니다.
방법 :
PATCH경로 :
/v1/sources/{source_id}
매개변수 :
source_id: source_id 매개변수(필수)user_id: user_id 매개변수
삭제_소스
ID :
DELETE-v1-sources-source-id설명 : 데이터 소스를 삭제합니다.
방법 :
DELETE경로 :
/v1/sources/{source_id}
매개변수 :
source_id: source_id 매개변수(필수)user_id: user_id 매개변수
이름으로 소스 ID 가져오기
ID :
GET-v1-sources-name-source-name설명 : 이름으로 소스 가져오기
방법 :
GET경로 :
/v1/sources/name/{source_name}
매개변수 :
source_name: source_name 매개변수(필수)user_id: user_id 매개변수
목록_소스
ID :
GET-v1-sources-설명 : 사용자가 만든 모든 데이터 소스를 나열합니다.
방법 :
GET경로 :
/v1/sources/
매개변수 :
user_id: user_id 매개변수
소스 생성
ID :
POST-v1-sources-설명 : 새로운 데이터 소스를 만듭니다.
방법 :
POST경로 :
/v1/sources/
매개변수 :
user_id: user_id 매개변수
소스에 파일 업로드
ID :
POST-v1-sources-source-id-upload설명 : 데이터 소스에 파일을 업로드합니다.
방법 :
POST경로 :
/v1/sources/{source_id}/upload
매개변수 :
source_id: source_id 매개변수(필수)user_id: user_id 매개변수
목록_소스_패스지
ID :
GET-v1-sources-source-id-passages설명 : 데이터 소스와 관련된 모든 구절을 나열합니다.
방법 :
GET경로 :
/v1/sources/{source_id}/passages
매개변수 :
source_id: source_id 매개변수(필수)user_id: user_id 매개변수
소스 파일 목록
ID :
GET-v1-sources-source-id-files설명 : 데이터 소스와 연관된 페이지별 파일을 나열합니다.
방법 :
GET경로 :
/v1/sources/{source_id}/files
매개변수 :
source_id: source_id 매개변수(필수)limit: 반환할 파일 수after: 다음 결과 세트를 가져오기 위한 페이지 매김 커서user_id: user_id 매개변수
소스에서 파일 삭제
ID :
DELETE-v1-sources-source-id-file-id설명 : 데이터 소스를 삭제합니다.
방법 :
DELETE경로 :
/v1/sources/{source_id}/{file_id}
매개변수 :
source_id: source_id 매개변수(필수)file_id: file_id 매개변수(필수)user_id: user_id 매개변수
목록_에이전트
ID :
GET-v1-agents-설명 : 지정된 사용자와 연관된 모든 에이전트를 나열합니다.
이 엔드포인트는 지정된 사용자 ID와 연관된 모든 에이전트와 해당 구성의 목록을 검색합니다.
방법 :
GET경로 :
/v1/agents/
매개변수 :
name: 대리인의 이름tags: 에이전트를 필터링할 태그 목록match_all_tags: True이면 주어진 모든 태그와 일치하는 에이전트만 반환합니다. 그렇지 않으면 전달된 태그 중 하나라도 일치하는 에이전트를 반환합니다.before: 페이지 매김을 위한 커서after: 페이지 매김을 위한 커서limit: 페이지 번호 매기기 제한query_text: 이름으로 에이전트 검색project_id: 프로젝트 ID로 에이전트 검색template_id: 템플릿 ID로 에이전트 검색base_template_id: 기본 템플릿 ID로 에이전트 검색identity_id: ID로 에이전트 검색identifier_keys: 식별자 키로 에이전트 검색include_relationships: 응답에 포함할 관계형 필드(예: 'tools', 'sources', 'memory')를 지정합니다. 이 값을 지정하지 않으면 기본적으로 모든 관계가 로드됩니다. 이 값을 사용하면 불필요한 조인을 줄여 성능을 최적화할 수 있습니다.ascending: 에이전트를 가장 오래된 것부터 가장 최근 것 순으로 정렬할지(True) 또는 가장 최근 것부터 가장 오래된 것 순으로 정렬할지(False, 기본값)user_id: user_id 매개변수
생성_에이전트
ID :
POST-v1-agents-설명 : 지정된 구성으로 새 에이전트를 만듭니다.
방법 :
POST경로 :
/v1/agents/
매개변수 :
user_id: user_id 매개변수X-Project: X-Project 매개변수
내보내기_에이전트_직렬화
ID :
GET-v1-agents-agent-id-export설명 : 에이전트의 직렬화된 JSON 표현을 내보냅니다.
방법 :
GET경로 :
/v1/agents/{agent_id}/export
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
가져오기_에이전트_직렬화
ID :
POST-v1-agents-import설명 : 직렬화된 에이전트 파일을 가져와서 시스템에 에이전트를 다시 생성합니다.
방법 :
POST경로 :
/v1/agents/import
매개변수 :
append_copy_suffix: True로 설정하면 에이전트 이름의 끝에 "_copy"를 추가합니다.override_existing_tools: True로 설정하면 기존 도구의 소스 코드를 업로드된 도구 정의로 덮어쓸 수 있습니다. Letta 핵심 도구는 외부에서 업데이트할 수 없습니다.project_id: 업로드된 에이전트와 연결할 프로젝트 ID입니다.user_id: user_id 매개변수
검색_에이전트_컨텍스트_창
ID :
GET-v1-agents-agent-id-context설명 : 특정 에이전트의 컨텍스트 창을 검색합니다.
방법 :
GET경로 :
/v1/agents/{agent_id}/context
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
수정_에이전트
ID :
PATCH-v1-agents-agent-id설명 : 기존 에이전트 업데이트
방법 :
PATCH경로 :
/v1/agents/{agent_id}
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
검색_에이전트
ID :
GET-v1-agents-agent-id설명 : 에이전트의 상태를 가져옵니다.
방법 :
GET경로 :
/v1/agents/{agent_id}
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
삭제_에이전트
ID :
DELETE-v1-agents-agent-id설명 : 에이전트를 삭제합니다.
방법 :
DELETE경로 :
/v1/agents/{agent_id}
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
리스트_에이전트_도구
ID :
GET-v1-agents-agent-id-tools설명 : 기존 에이전트로부터 도구 가져오기
방법 :
GET경로 :
/v1/agents/{agent_id}/tools
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
첨부_도구
ID :
PATCH-v1-agents-agent-id-tools-attach-tool-id설명 : 에이전트에 도구를 부착합니다.
방법 :
PATCH경로 :
/v1/agents/{agent_id}/tools/attach/{tool_id}
매개변수 :
agent_id: agent_id 매개변수(필수)tool_id: tool_id 매개변수(필수)user_id: user_id 매개변수
분리_도구
ID :
PATCH-v1-agents-agent-id-tools-detach-tool-id설명 : 에이전트에서 도구를 분리합니다.
방법 :
PATCH경로 :
/v1/agents/{agent_id}/tools/detach/{tool_id}
매개변수 :
agent_id: agent_id 매개변수(필수)tool_id: tool_id 매개변수(필수)user_id: user_id 매개변수
소스를 에이전트에 첨부
ID :
PATCH-v1-agents-agent-id-sources-attach-source-id설명 : 에이전트에 소스를 첨부합니다.
방법 :
PATCH경로 :
/v1/agents/{agent_id}/sources/attach/{source_id}
매개변수 :
agent_id: agent_id 매개변수(필수)source_id: source_id 매개변수(필수)user_id: user_id 매개변수
에이전트에서 소스 분리
ID :
PATCH-v1-agents-agent-id-sources-detach-source-id설명 : 에이전트에서 소스를 분리합니다.
방법 :
PATCH경로 :
/v1/agents/{agent_id}/sources/detach/{source_id}
매개변수 :
agent_id: agent_id 매개변수(필수)source_id: source_id 매개변수(필수)user_id: user_id 매개변수
목록_에이전트_소스
ID :
GET-v1-agents-agent-id-sources설명 : 에이전트와 관련된 소스를 가져옵니다.
방법 :
GET경로 :
/v1/agents/{agent_id}/sources
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
검색_에이전트_메모리
ID :
GET-v1-agents-agent-id-core-memory설명 : 특정 에이전트의 메모리 상태를 검색합니다. 이 엔드포인트는 사용자 ID와 에이전트 ID로 식별된 에이전트의 현재 메모리 상태를 가져옵니다.
방법 :
GET경로 :
/v1/agents/{agent_id}/core-memory
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
검색_코어_메모리_블록
ID :
GET-v1-agents-agent-id-core-memory-blocks-block-label설명 : 에이전트로부터 코어 메모리 블록을 검색합니다.
방법 :
GET경로 :
/v1/agents/{agent_id}/core-memory/blocks/{block_label}
매개변수 :
agent_id: agent_id 매개변수(필수)block_label: block_label 매개변수(필수)user_id: user_id 매개변수
코어 메모리 블록 수정
ID :
PATCH-v1-agents-agent-id-core-memory-blocks-block-label설명 : 에이전트의 코어 메모리 블록을 업데이트합니다.
방법 :
PATCH경로 :
/v1/agents/{agent_id}/core-memory/blocks/{block_label}
매개변수 :
agent_id: agent_id 매개변수(필수)block_label: block_label 매개변수(필수)user_id: user_id 매개변수
목록_코어_메모리_블록
ID :
GET-v1-agents-agent-id-core-memory-blocks설명 : 특정 에이전트의 핵심 메모리 블록을 검색합니다.
방법 :
GET경로 :
/v1/agents/{agent_id}/core-memory/blocks
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
코어 메모리 블록을 첨부하세요
ID :
PATCH-v1-agents-agent-id-core-memory-blocks-attach-block-id설명 : 에이전트에 코어 메모리 블록을 부착합니다.
방법 :
PATCH경로 :
/v1/agents/{agent_id}/core-memory/blocks/attach/{block_id}
매개변수 :
agent_id: agent_id 매개변수(필수)block_id: block_id 매개변수(필수)user_id: user_id 매개변수
코어 메모리 블록 분리
ID :
PATCH-v1-agents-agent-id-core-memory-blocks-detach-block-id설명 : 에이전트에서 코어 메모리 블록을 분리합니다.
방법 :
PATCH경로 :
/v1/agents/{agent_id}/core-memory/blocks/detach/{block_id}
매개변수 :
agent_id: agent_id 매개변수(필수)block_id: block_id 매개변수(필수)user_id: user_id 매개변수
목록_구절
ID :
GET-v1-agents-agent-id-archival-memory설명 : 에이전트의 보관 메모리 저장소에서 메모리를 검색합니다(페이지별 쿼리).
방법 :
GET경로 :
/v1/agents/{agent_id}/archival-memory
매개변수 :
agent_id: agent_id 매개변수(필수)after: 쿼리 범위를 시작할 메모리의 고유 ID입니다.before: 쿼리 범위를 종료할 메모리의 고유 ID입니다.limit: 응답에 포함할 결과의 수.search: 텍스트로 구절 검색ascending: 구절을 가장 오래된 것부터 가장 최근 것 순으로 정렬할지(True, 기본값) 또는 가장 최근 것부터 가장 오래된 것 순으로 정렬할지(False)user_id: user_id 매개변수
생성_통로
ID :
POST-v1-agents-agent-id-archival-memory설명 : 에이전트의 보관 메모리 저장소에 메모리를 삽입합니다.
방법 :
POST경로 :
/v1/agents/{agent_id}/archival-memory
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
수정_통로
ID :
PATCH-v1-agents-agent-id-archival-memory-memory-id설명 : 에이전트의 보관 메모리 저장소에서 메모리를 수정합니다.
방법 :
PATCH경로 :
/v1/agents/{agent_id}/archival-memory/{memory_id}
매개변수 :
agent_id: agent_id 매개변수(필수)memory_id: memory_id 매개변수(필수)user_id: user_id 매개변수
삭제_통로
ID :
DELETE-v1-agents-agent-id-archival-memory-memory-id설명 : 에이전트의 보관 메모리 저장소에서 메모리를 삭제합니다.
방법 :
DELETE경로 :
/v1/agents/{agent_id}/archival-memory/{memory_id}
매개변수 :
agent_id: agent_id 매개변수(필수)memory_id: memory_id 매개변수(필수)user_id: user_id 매개변수
목록_메시지
ID :
GET-v1-agents-agent-id-messages설명 : 에이전트의 메시지 기록을 검색합니다.
방법 :
GET경로 :
/v1/agents/{agent_id}/messages
매개변수 :
agent_id: agent_id 매개변수(필수)after: 반환된 메시지를 검색할 이후의 메시지입니다.before: 반환된 메시지를 검색할 이전 메시지입니다.limit: 검색할 최대 메시지 수.use_assistant_message: 보조 메시지를 사용할지 여부assistant_message_tool_name: 지정된 메시지 도구의 이름입니다.assistant_message_tool_kwarg: 메시지 인수의 이름입니다.user_id: user_id 매개변수
메시지 보내기
ID :
POST-v1-agents-agent-id-messages설명 : 사용자 메시지를 처리하고 에이전트의 응답을 반환합니다. 이 엔드포인트는 사용자로부터 메시지를 수신하고 에이전트를 통해 처리합니다.
방법 :
POST경로 :
/v1/agents/{agent_id}/messages
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
수정_메시지
ID :
PATCH-v1-agents-agent-id-messages-message-id설명 : 에이전트와 관련된 메시지의 세부 정보를 업데이트합니다.
방법 :
PATCH경로 :
/v1/agents/{agent_id}/messages/{message_id}
매개변수 :
agent_id: agent_id 매개변수(필수)message_id: message_id 매개변수(필수)user_id: user_id 매개변수
에이전트 메시지 스트림 생성
ID :
POST-v1-agents-agent-id-messages-stream설명 : 사용자 메시지를 처리하고 에이전트의 응답을 반환합니다. 이 엔드포인트는 사용자로부터 메시지를 수신하여 에이전트를 통해 처리합니다. 응답의 각 단계를 항상 스트리밍하며, 'stream_tokens'가 True로 설정된 경우 토큰도 스트리밍합니다.
방법 :
POST경로 :
/v1/agents/{agent_id}/messages/stream
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
비동기 에이전트 메시지 생성
ID :
POST-v1-agents-agent-id-messages-async설명 : 사용자 메시지를 비동기적으로 처리하고 실행 객체를 반환합니다. 실제 처리는 백그라운드에서 수행되며, 실행 ID를 사용하여 상태를 확인할 수 있습니다.
방법 :
POST경로 :
/v1/agents/{agent_id}/messages/async
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
리셋_메시지
ID :
PATCH-v1-agents-agent-id-reset-messages설명 : 에이전트의 메시지를 재설정합니다.
방법 :
PATCH경로 :
/v1/agents/{agent_id}/reset-messages
매개변수 :
agent_id: agent_id 매개변수(필수)add_default_initial_messages: true인 경우 재설정 후 기본 초기 메시지를 추가합니다.user_id: user_id 매개변수
생성_그룹
ID :
POST-v1-groups-설명 : 지정된 구성으로 새로운 다중 에이전트 그룹을 만듭니다.
방법 :
POST경로 :
/v1/groups/
매개변수 :
user_id: user_id 매개변수X-Project: X-Project 매개변수
목록_그룹
ID :
GET-v1-groups-설명 : 쿼리와 일치하는 모든 다중 에이전트 그룹을 가져옵니다.
방법 :
GET경로 :
/v1/groups/
매개변수 :
manager_type: 관리자 유형별로 그룹 검색before: 페이지 매김을 위한 커서after: 페이지 매김을 위한 커서limit: 페이지 번호 매기기 제한project_id: 프로젝트 ID로 그룹 검색user_id: user_id 매개변수
업서트_그룹
ID :
PUT-v1-groups-설명 : 지정된 구성으로 새로운 다중 에이전트 그룹을 만듭니다.
방법 :
PUT경로 :
/v1/groups/
매개변수 :
user_id: user_id 매개변수X-Project: X-Project 매개변수
그룹 삭제
ID :
DELETE-v1-groups-group-id설명 : 다중 에이전트 그룹을 삭제합니다.
방법 :
DELETE경로 :
/v1/groups/{group_id}
매개변수 :
group_id: group_id 매개변수(필수)user_id: user_id 매개변수
그룹 메시지 보내기
ID :
POST-v1-groups-group-id-messages설명 : 사용자 메시지를 처리하고 그룹의 응답을 반환합니다. 이 엔드포인트는 사용자로부터 메시지를 수신하고 지정된 패턴에 따라 그룹 내 에이전트를 통해 처리합니다.
방법 :
POST경로 :
/v1/groups/{group_id}/messages
매개변수 :
agent_id: agent_id 매개변수(필수)user_id: user_id 매개변수
그룹 메시지 목록
ID :
GET-v1-groups-group-id-messages설명 : 에이전트의 메시지 기록을 검색합니다.
방법 :
GET경로 :
/v1/groups/{group_id}/messages
매개변수 :
group_id: group_id 매개변수(필수)after: 반환된 메시지를 검색할 이후의 메시지입니다.before: 반환된 메시지를 검색할 이전 메시지입니다.limit: 검색할 최대 메시지 수.use_assistant_message: 보조 메시지를 사용할지 여부assistant_message_tool_name: 지정된 메시지 도구의 이름입니다.assistant_message_tool_kwarg: 메시지 인수의 이름입니다.user_id: user_id 매개변수
그룹 메시지 스트리밍 전송
ID :
POST-v1-groups-group-id-messages-stream설명 : 사용자 메시지를 처리하고 그룹의 응답을 반환합니다. 이 엔드포인트는 사용자로부터 메시지를 수신하여 지정된 패턴에 따라 그룹 내 에이전트를 통해 처리합니다. 응답의 각 단계를 항상 스트리밍하며, 'stream_tokens'가 True로 설정된 경우 토큰도 스트리밍합니다.
방법 :
POST경로 :
/v1/groups/{group_id}/messages/stream
매개변수 :
group_id: group_id 매개변수(필수)user_id: user_id 매개변수
목록_아이덴티티
ID :
GET-v1-identities-설명 : 데이터베이스에 있는 모든 ID 목록을 가져옵니다.
방법 :
GET경로 :
/v1/identities/
매개변수 :
name: 이름 매개변수project_id: project_id 매개변수identifier_key: 식별자_키 매개변수identity_type: identity_type 매개변수before: 매개변수 이전after: 매개변수 이후limit: 한계 매개변수user_id: user_id 매개변수
신원 생성
ID :
POST-v1-identities-설명 : /v1/identities/에 POST 요청을 만듭니다.
방법 :
POST경로 :
/v1/identities/
매개변수 :
user_id: user_id 매개변수X-Project: X-Project 매개변수
업서트_아이덴티티
ID :
PUT-v1-identities-설명 : /v1/identities/에 PUT 요청을 만듭니다.
방법 :
PUT경로 :
/v1/identities/
매개변수 :
user_id: user_id 매개변수X-Project: X-Project 매개변수
검색_신원
ID :
GET-v1-identities-identity-id설명 : /v1/identities/{identity_id}에 GET 요청을 만듭니다.
방법 :
GET경로 :
/v1/identities/{identity_id}
매개변수 :
identity_id: identity_id 매개변수(필수)user_id: user_id 매개변수
업데이트_아이덴티티
ID :
PATCH-v1-identities-identity-id설명 : /v1/identities/{identity_id}에 PATCH 요청을 만듭니다.
방법 :
PATCH경로 :
/v1/identities/{identity_id}
매개변수 :
identity_id: identity_id 매개변수(필수)user_id: user_id 매개변수
삭제_아이덴티티
ID :
DELETE-v1-identities-identity-id설명 : 식별자 키로 ID 삭제
방법 :
DELETE경로 :
/v1/identities/{identity_id}
매개변수 :
identity_id: identity_id 매개변수(필수)user_id: user_id 매개변수
리스트_모델
ID :
GET-v1-models-설명 : /v1/models/에 GET 요청을 만듭니다.
방법 :
GET경로 :
/v1/models/
매개변수가 필요하지 않습니다.
리스트_임베딩_모델
ID :
GET-v1-models-embedding설명 : /v1/models/embedding에 GET 요청을 만듭니다.
방법 :
GET경로 :
/v1/models/embedding
매개변수가 필요하지 않습니다.
블록 목록
ID :
GET-v1-blocks-설명 : /v1/blocks/에 GET 요청을 만듭니다.
방법 :
GET경로 :
/v1/blocks/
매개변수 :
label: 포함할 레이블(예: 인간, 페르소나)templates_only: 템플릿만 포함할지 여부name: 블록의 이름identity_id: 식별자 ID로 에이전트 검색identifier_keys: 식별자 키로 에이전트 검색user_id: user_id 매개변수
블록 생성
ID :
POST-v1-blocks-설명 : /v1/blocks/에 POST 요청을 만듭니다.
방법 :
POST경로 :
/v1/blocks/
매개변수 :
user_id: user_id 매개변수
수정_블록
ID :
PATCH-v1-blocks-block-id설명 : /v1/blocks/{block_id}에 PATCH 요청을 만듭니다.
방법 :
PATCH경로 :
/v1/blocks/{block_id}
매개변수 :
block_id: block_id 매개변수(필수)user_id: user_id 매개변수
블록 삭제
ID :
DELETE-v1-blocks-block-id설명 : /v1/blocks/{block_id}에 DELETE 요청을 만듭니다.
방법 :
DELETE경로 :
/v1/blocks/{block_id}
매개변수 :
block_id: block_id 매개변수(필수)user_id: user_id 매개변수
블록 검색
ID :
GET-v1-blocks-block-id설명 : /v1/blocks/{block_id}에 GET 요청을 만듭니다.
방법 :
GET경로 :
/v1/blocks/{block_id}
매개변수 :
block_id: block_id 매개변수(필수)user_id: user_id 매개변수
블록에 대한 에이전트 목록
ID :
GET-v1-blocks-block-id-agents설명 : 지정된 블록과 연결된 모든 에이전트를 검색합니다. 블록이 없으면 404 오류를 발생시킵니다.
방법 :
GET경로 :
/v1/blocks/{block_id}/agents
매개변수 :
block_id: block_id 매개변수(필수)user_id: user_id 매개변수
일자리 목록
ID :
GET-v1-jobs-설명 : 모든 일자리를 나열합니다.
방법 :
GET경로 :
/v1/jobs/
매개변수 :
source_id: 소스와 연관된 작업만 나열합니다.user_id: user_id 매개변수
활성 작업 목록
ID :
GET-v1-jobs-active설명 : 모든 활성 작업을 나열합니다.
방법 :
GET경로 :
/v1/jobs/active
매개변수 :
user_id: user_id 매개변수
검색_작업
ID :
GET-v1-jobs-job-id설명 : 작업 상태를 가져옵니다.
방법 :
GET경로 :
/v1/jobs/{job_id}
매개변수 :
job_id: job_id 매개변수(필수)user_id: user_id 매개변수
삭제_작업
ID :
DELETE-v1-jobs-job-id설명 : job_id로 작업을 삭제합니다.
방법 :
DELETE경로 :
/v1/jobs/{job_id}
매개변수 :
job_id: job_id 매개변수(필수)user_id: user_id 매개변수
건강 검진
ID :
GET-v1-health-설명 : /v1/health/에 GET 요청을 만듭니다.
방법 :
GET경로 :
/v1/health/
매개변수가 필요하지 않습니다.
create_sandbox_config_v1_sandbox_config__post
ID :
POST-v1-sandbox-config-설명 : /v1/sandbox-config/에 POST 요청을 만듭니다.
방법 :
POST경로 :
/v1/sandbox-config/
매개변수 :
user-id: 사용자 ID 매개변수
list_sandbox_configs_v1_sandbox_config__get
ID :
GET-v1-sandbox-config-설명 : /v1/sandbox-config/에 GET 요청을 만듭니다.
방법 :
GET경로 :
/v1/sandbox-config/
매개변수 :
limit: 반환할 결과 수after: 다음 결과 세트를 가져오기 위한 페이지 매김 커서sandbox_type: 이 특정 샌드박스 유형에 대한 필터user-id: 사용자 ID 매개변수
create_default_e2b_sandbox_config_v1_sandbox_config_e2b_default_post
ID :
POST-v1-sandbox-config-e2b-default설명 : /v1/sandbox-config/e2b/default에 POST 요청을 만듭니다.
방법 :
POST경로 :
/v1/sandbox-config/e2b/default
매개변수 :
user-id: 사용자 ID 매개변수
create_default_local_sandbox_config_v1_sandbox_config_local_default_post
ID :
POST-v1-sandbox-config-local-default설명 : /v1/sandbox-config/local/default에 POST 요청을 만듭니다.
방법 :
POST경로 :
/v1/sandbox-config/local/default
매개변수 :
user-id: 사용자 ID 매개변수
create_custom_local_sandbox_config_v1_sandbox_config_local_post
ID :
POST-v1-sandbox-config-local설명 : pip_requirements를 포함하여 사용자 정의 LocalSandboxConfig를 생성하거나 업데이트합니다.
방법 :
POST경로 :
/v1/sandbox-config/local
매개변수 :
user-id: 사용자 ID 매개변수
업데이트_샌드박스_구성_v1_샌드박스_구성__샌드박스_구성_id__패치
ID :
PATCH-v1-sandbox-config-sandbox-config-id설명 : /v1/sandbox-config/{sandbox_config_id}에 PATCH 요청을 만듭니다.
방법 :
PATCH경로 :
/v1/sandbox-config/{sandbox_config_id}
매개변수 :
sandbox_config_id: sandbox_config_id 매개변수(필수)user-id: 사용자 ID 매개변수
delete_sandbox_config_v1_sandbox_config__sandbox_config_id__삭제
ID :
DELETE-v1-sandbox-config-sandbox-config-id설명 : /v1/sandbox-config/{sandbox_config_id}에 DELETE 요청을 만듭니다.
방법 :
DELETE경로 :
/v1/sandbox-config/{sandbox_config_id}
매개변수 :
sandbox_config_id: sandbox_config_id 매개변수(필수)user-id: 사용자 ID 매개변수
로컬 샌드박스 venv_v1 샌드박스 구성 로컬 venv_post를 강제로 다시 만듭니다.
ID :
POST-v1-sandbox-config-local-recreate-venv설명 : 로컬 샌드박스의 가상 환경을 강제로 다시 생성합니다. venv를 삭제하고 다시 생성한 후 필요한 종속성을 다시 설치합니다.
방법 :
POST경로 :
/v1/sandbox-config/local/recreate-venv
매개변수 :
user-id: 사용자 ID 매개변수
샌드박스 환경 변수 v1 샌드박스 구성 생성 샌드박스 구성 ID 환경 변수 게시
ID :
POST-v1-sandbox-config-sandbox-config-id-environment-variable설명 : /v1/sandbox-config/{sandbox_config_id}/environment-variable에 POST 요청을 만듭니다.
방법 :
POST경로 :
/v1/sandbox-config/{sandbox_config_id}/environment-variable
매개변수 :
sandbox_config_id: sandbox_config_id 매개변수(필수)user-id: 사용자 ID 매개변수
list_sandbox_env_vars_v1_sandbox_config__sandbox_config_id__환경_변수_get
ID :
GET-v1-sandbox-config-sandbox-config-id-environment-variable설명 : /v1/sandbox-config/{sandbox_config_id}/environment-variable에 GET 요청을 만듭니다.
방법 :
GET경로 :
/v1/sandbox-config/{sandbox_config_id}/environment-variable
매개변수 :
sandbox_config_id: sandbox_config_id 매개변수(필수)limit: 반환할 결과 수after: 다음 결과 세트를 가져오기 위한 페이지 매김 커서user-id: 사용자 ID 매개변수
업데이트_샌드박스_환경_변수_v1_샌드박스_구성_환경_변수__환경_변수_id__패치
ID :
PATCH-v1-sandbox-config-environment-variable-env-var-id설명 : /v1/sandbox-config/environment-variable/{env_var_id}에 대한 PATCH 요청을 만듭니다.
방법 :
PATCH경로 :
/v1/sandbox-config/environment-variable/{env_var_id}
매개변수 :
env_var_id: env_var_id 매개변수(필수)user-id: 사용자 ID 매개변수
delete_sandbox_env_var_v1_sandbox_config_environment_variable__env_var_id__삭제
ID :
DELETE-v1-sandbox-config-environment-variable-env-var-id설명 : /v1/sandbox-config/environment-variable/{env_var_id}에 대한 DELETE 요청을 만듭니다.
방법 :
DELETE경로 :
/v1/sandbox-config/environment-variable/{env_var_id}
매개변수 :
env_var_id: env_var_id 매개변수(필수)user-id: 사용자 ID 매개변수
목록_공급자
ID :
GET-v1-providers-설명 : 데이터베이스에 있는 모든 사용자 정의 공급자 목록을 가져옵니다.
방법 :
GET경로 :
/v1/providers/
매개변수 :
after: 매개변수 이후limit: 한계 매개변수user_id: user_id 매개변수
생성_공급자
ID :
POST-v1-providers-설명 : 새로운 사용자 정의 공급자 만들기
방법 :
POST경로 :
/v1/providers/
매개변수 :
user_id: user_id 매개변수
수정_공급자
ID :
PATCH-v1-providers-설명 : 기존 사용자 정의 공급자 업데이트
방법 :
PATCH경로 :
/v1/providers/
매개변수 :
user_id: user_id 매개변수
공급자 삭제
ID :
DELETE-v1-providers-설명 : 기존 사용자 정의 공급자 삭제
방법 :
DELETE경로 :
/v1/providers/
매개변수 :
provider_id: 삭제할 provider_id 키입니다. (필수)user_id: user_id 매개변수
리스트_런
ID :
GET-v1-runs-설명 : 모든 실행을 나열합니다.
방법 :
GET경로 :
/v1/runs/
매개변수 :
user_id: user_id 매개변수
활성 실행 목록
ID :
GET-v1-runs-active설명 : 모든 활성 실행을 나열합니다.
방법 :
GET경로 :
/v1/runs/active
매개변수 :
user_id: user_id 매개변수
검색_실행
ID :
GET-v1-runs-run-id설명 : 실행 상태를 가져옵니다.
방법 :
GET경로 :
/v1/runs/{run_id}
매개변수 :
run_id: run_id 매개변수(필수)user_id: user_id 매개변수
삭제_실행
ID :
DELETE-v1-runs-run-id설명 : run_id로 실행을 삭제합니다.
방법 :
DELETE경로 :
/v1/runs/{run_id}
매개변수 :
run_id: run_id 매개변수(필수)user_id: user_id 매개변수
목록_실행_메시지
ID :
GET-v1-runs-run-id-messages설명 : 필터링 옵션을 사용하여 실행과 관련된 메시지를 가져옵니다.
인수: run_id: 실행 ID before: 페이지 매김에 사용할 커서. before 목록에서의 위치를 정의하는 객체 ID입니다. 예를 들어, 목록 요청을 하고 obj_foo로 시작하는 100개의 객체를 수신하는 경우, 후속 호출에 before=obj_foo를 포함하여 목록의 이전 페이지를 가져올 수 있습니다. after: 페이지 매김에 사용할 커서. after 목록에서의 위치를 정의하는 객체 ID입니다. 예를 들어, 목록 요청을 하고 obj_foo로 끝나는 100개의 객체를 수신하는 경우, 후속 호출에 after=obj_foo를 포함하여 목록의 다음 페이지를 가져올 수 있습니다. limit: 반환할 최대 메시지 수 order: 객체의 created_at 타임스탬프를 기준으로 정렬합니다. 오름차순은 asc, 내림차순은 desc입니다. role: 역할(user/assistant/system/tool)로 필터링 return_message_object: Message 객체 또는 LettaMessage 객체를 반환할지 여부 user_id: 요청한 사용자의 ID
반환값: 실행과 관련된 메시지 목록. 기본값은 List[LettaMessage]입니다.
방법 :
GET경로 :
/v1/runs/{run_id}/messages
매개변수 :
run_id: run_id 매개변수(필수)before: 페이지 매김을 위한 커서after: 페이지 매김을 위한 커서limit: 반환할 최대 메시지 수order: 객체의 created_at 타임스탬프를 기준으로 정렬합니다. 오름차순은 asc, 내림차순은 desc입니다.role: 역할별 필터링user_id: user_id 매개변수
검색_실행_사용법
ID :
GET-v1-runs-run-id-usage설명 : 실행에 대한 사용 통계를 가져옵니다.
방법 :
GET경로 :
/v1/runs/{run_id}/usage
매개변수 :
run_id: run_id 매개변수(필수)user_id: user_id 매개변수
목록_실행_단계
ID :
GET-v1-runs-run-id-steps설명 : 필터링 옵션을 사용하여 실행과 관련된 메시지를 가져옵니다.
인수: run_id: 실행 ID before: 페이지 매김에 사용할 커서. before 목록에서의 위치를 정의하는 객체 ID입니다. 예를 들어, 목록 요청을 하고 obj_foo로 시작하는 100개의 객체를 받는 경우 후속 호출에서 before=obj_foo를 포함하여 목록의 이전 페이지를 가져올 수 있습니다. after: 페이지 매김에 사용할 커서. after 목록에서의 위치를 정의하는 객체 ID입니다. 예를 들어, 목록 요청을 하고 obj_foo로 끝나는 100개의 객체를 받는 경우 후속 호출에서 after=obj_foo를 포함하여 목록의 다음 페이지를 가져올 수 있습니다. limit: 반환할 최대 단계 수 order: 객체의 created_at 타임스탬프를 기준으로 정렬합니다. 오름차순의 경우 asc, 내림차순의 경우 desc.
반환: 실행과 관련된 단계 목록입니다.
방법 :
GET경로 :
/v1/runs/{run_id}/steps
매개변수 :
run_id: run_id 매개변수(필수)before: 페이지 매김을 위한 커서after: 페이지 매김을 위한 커서limit: 반환할 최대 메시지 수order: 객체의 created_at 타임스탬프를 기준으로 정렬합니다. 오름차순은 asc, 내림차순은 desc입니다.user_id: user_id 매개변수
목록_단계
ID :
GET-v1-steps설명 : 페이지 매김 및 날짜 필터(선택 사항)를 사용하여 단계를 나열합니다. 날짜는 ISO 8601 형식(예: 2025-01-29T15:01:19-08:00)으로 제공해야 합니다.
방법 :
GET경로 :
/v1/steps
매개변수 :
before: 이 단계 ID 이전의 단계를 반환합니다.after: 이 단계 ID 이후의 단계를 반환합니다.limit: 반환할 최대 단계 수order: 정렬 순서(오름차순 또는 내림차순)start_date: 이 ISO datetime 이후의 단계를 반환합니다(예: "2025-01-29T15:01:19-08:00")end_date: 이 ISO datetime 이전의 단계를 반환합니다(예: "2025-01-29T15:01:19-08:00")model: 단계에 사용된 모델 이름으로 필터링agent_id: 단계를 수행한 에이전트의 ID로 필터링user_id: user_id 매개변수
검색_단계
ID :
GET-v1-steps-step-id설명 : ID로 단계를 가져옵니다.
방법 :
GET경로 :
/v1/steps/{step_id}
매개변수 :
step_id: step_id 매개변수(필수)user_id: user_id 매개변수
업데이트_단계_거래_ID
ID :
PATCH-v1-steps-step-id-transaction-transaction-id설명 : 단계에 대한 거래 ID를 업데이트합니다.
방법 :
PATCH경로 :
/v1/steps/{step_id}/transaction/{transaction_id}
매개변수 :
step_id: step_id 매개변수(필수)transaction_id: transaction_id 매개변수(필수)user_id: user_id 매개변수
태그 목록
ID :
GET-v1-tags-설명 : 데이터베이스에 있는 모든 태그 목록을 가져옵니다.
방법 :
GET경로 :
/v1/tags/
매개변수 :
after: 매개변수 이후limit: 한계 매개변수query_text: 쿼리_텍스트 매개변수user_id: user_id 매개변수
음성 채팅 완성 생성
ID :
POST-v1-voice-beta-agent-id-chat-completions설명 : /v1/voice-beta/{agent_id}/chat/completions에 POST 요청을 만듭니다.
방법 :
POST경로 :
/v1/voice-beta/{agent_id}/chat/completions
매개변수 :
agent_id: agent_id 매개변수(필수)user-id: 사용자 ID 매개변수
사용자 목록
ID :
GET-v1-admin-users-설명 : 데이터베이스에 있는 모든 사용자 목록을 가져옵니다.
방법 :
GET경로 :
/v1/admin/users/
매개변수 :
after: 매개변수 이후limit: 한계 매개변수
사용자 생성
ID :
POST-v1-admin-users-설명 : 데이터베이스에 새 사용자를 만듭니다.
방법 :
POST경로 :
/v1/admin/users/
매개변수가 필요하지 않습니다.
업데이트_사용자
ID :
PUT-v1-admin-users-설명 : 데이터베이스의 사용자 업데이트
방법 :
PUT경로 :
/v1/admin/users/
매개변수가 필요하지 않습니다.
사용자 삭제
ID :
DELETE-v1-admin-users-설명 : /v1/admin/users/에 DELETE 요청을 만듭니다.
방법 :
DELETE경로 :
/v1/admin/users/
매개변수 :
user_id: 삭제할 user_id 키입니다. (필수)
목록_조직
ID :
GET-v1-admin-orgs-설명 : 데이터베이스에 있는 모든 조직 목록을 가져옵니다.
방법 :
GET경로 :
/v1/admin/orgs/
매개변수 :
after: 매개변수 이후limit: 한계 매개변수
조직 생성
ID :
POST-v1-admin-orgs-설명 : 데이터베이스에 새 조직을 만듭니다.
방법 :
POST경로 :
/v1/admin/orgs/
매개변수가 필요하지 않습니다.
ID로 조직 삭제
ID :
DELETE-v1-admin-orgs-설명 : /v1/admin/orgs/에 DELETE 요청을 만듭니다.
방법 :
DELETE경로 :
/v1/admin/orgs/
매개변수 :
org_id: 삭제할 org_id 키입니다. (필수)
업데이트_조직
ID :
PATCH-v1-admin-orgs-설명 : /v1/admin/orgs/에 PATCH 요청을 만듭니다.
방법 :
PATCH경로 :
/v1/admin/orgs/
매개변수 :
org_id: 업데이트할 org_id 키입니다. (필수)
채팅_완료_생성
ID :
POST-openai-v1-agent-id-chat-completions설명 : /openai/v1/{agent_id}/chat/completions에 POST 요청을 만듭니다.
방법 :
POST경로 :
/openai/v1/{agent_id}/chat/completions
매개변수 :
agent_id: agent_id 매개변수(필수)user-id: 사용자 ID 매개변수
authenticate_user_v1_auth_post
ID :
POST-v1-auth설명 : 사용자를 인증하고 사용자 관련 데이터가 포함된 응답을 보냅니다.
현재 이것은 단순히 UUID 플레이스홀더를 반환하는 플레이스홀더입니다.
방법 :
POST경로 :
/v1/auth
매개변수가 필요하지 않습니다.
특허
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
No tool schema history has been recorded yet.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
MCP-first control plane for ProAgentStore agents and private instances.
Discover and call AI agents via MCP. Supports A2A agents and platform agents with async tasks.
Create and manage Mermaid.js flowcharts and diagrams with AI agents via MCP.
MCP Server for an Agent Task Marketplace
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables management of Mistral AI agents through MCP tools including creating, listing, searching, viewing details, and deleting agents. Integrates with Mistral API to provide agent management capabilities through natural language interactions.1-
- FlicenseAqualityFmaintenanceMCP server that exposes 300+ AI agents as tools via a single API key. Supports listing agents, invoking any agent with chat-completion style messages, checking agent health, and retrieving platform statistics.53-
- AlicenseNot gradedqualityBmaintenanceAgent Delegation - MCP server providing AI-powered tools and automation by MEOK AI Labs15MIT
- AlicenseBqualityCmaintenanceMCP server that lets AI agents control Perssona. It enables creating terminals, managing canvas nodes, sending prompts, and running multi-agent workflows.2024MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/elijahdev0/mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server