Sume MCP 도구 목록: 읽기·쓰기·유료로 나눈 호스팅 도구
Sume MCP 도구를 계열별로 정리했습니다. 읽기만 하는 호스팅 도구, 쓰는 도구, 유료 Job을 시작하는 도구, 호스팅 MCP에 아예 없는 도구 이름을 구분합니다.
Sume MCP 도구 목록은 https://mcp.sume.com/mcp 호스팅 서버의 도구를 메타, 계정과 카탈로그, Job, 에셋, 생성, 아바타, 크롤, 미디어 계열로 묶습니다. 각 계열 안에서 도구는 읽거나, 쓰거나, 유료 Job을 제출하며, 쓰기·유료 도구는 mcp:write나 API 키가 있는 세션에만 나타납니다. 세션에서 보이는 정확한 도구 세트는 tools_list가 반환합니다.
이 목록은 MCP 도구와 게이트를 바탕으로 하며, 2026-09-26에 확인했습니다. 문서가 분류를 밝히지 않고 도구를 묶은 곳에서는, 표시한 분류가 호스팅 서버의 현재 동작입니다. 호스팅 MCP는 HTTP API와 기능이 완전히 같지 않으므로, 이 목록은 계약이 아니라 지도로 봐 주세요. 기초 페이지는 CLI와 호스팅 MCP가 여전히 동작하지만 현재 주 연동 경로는 아니라고 설명합니다.
라이브 도구 목록은 어떻게 받나요?
무엇보다 먼저 탐색 도구를 호출하세요. 라이브 계약은 항상 직접 확인하고, HTTP API와 같을 것이라고 가정하지 마세요.
tools_list는 세션에서 보이는 모든 도구를 안전 메타데이터와 함께 나열합니다. 현재 각 항목의safety블록에는read_only,paid_generation,requires_idempotency_key가 담깁니다.tools_schema는name으로 도구 하나의 계약을 가져옵니다.mcp_health는 엔드포인트 준비 상태, 인증 출처, 안전 설정을 알려 줍니다.- 도구 ID는 밑줄을 씁니다. 서버가 호출 시
.을_로 정규화하므로,tools.list같은 점 별칭도 여전히 동작합니다. - 별칭 두 개는 폐기됐습니다.
image-generations_create는generate_image로,video-router_create는generate_video로 바뀌었습니다. 현재 서버는 옛 이름으로 들어온 호출도 여전히 새 이름으로 연결하지만, 목록에는 새 이름만 나옵니다.
어떤 Sume MCP 도구가 읽고, 쓰고, 비용을 쓰나요?
유료 도구는 과금되는 Job을 제출하며, 쓰기·유료 도구는 idempotency_key를 받습니다. 생성 도구에서는 사용자가 패밀리를 지정하지 않았다면 payload.model을 생략해 sume/auto로 라우팅하세요. mcp:read만 있는 OAuth 세션에는 읽기 열의 도구만 보입니다. 로그인 방식별 규칙은 Claude Code·Cursor·Codex를 호스팅 MCP로 Sume에 연결에 있습니다.
표에서는 메타 도구와 함께 나열되는 script_run을 뺐습니다. 읽기 전용이 아니므로 읽기 전용 세션에는 보이지 않으며, 이 도구가 호출하는 각 도구는 자기 게이트를 그대로 유지합니다(프로그래밍 방식 도구 호출).
| 계열 | 읽기 | 쓰기 | 유료 |
|---|---|---|---|
| 메타와 헬스 | mcp_health, tools_list, tools_schema, health_service, health_v1 | 없음 | 없음 |
| 계정과 카탈로그 | account_me, balance_get, usage_get, catalog_list, image-models_list, image-models_get, video-router_models, generation_admission_preview | 없음 | 없음 |
| Job | jobs_list, jobs_get, jobs_status, jobs_result, jobs_events, jobs_wait | jobs_cancel | 없음 |
| 에셋 | assets_list, assets_get, assets_download_url | assets_create, assets_upload_url, assets_complete | 없음 |
| 이미지, 영상, 오디오 | tts_source_get, tts_source_verify_spine | 없음 | generate_image, generate_video, music_create, tts_create, stt_create, image_upscale_create, rmbg_create, video_upscale_create, kling-motion-control_create |
| 아바타 | avatars_list, avatars_get, avatars_search, avatar-videos_list, avatar-videos_get | 없음 | avatars_create, avatar-videos_create, avatar-image-to-video_create, avatar-video-previews_create, avatar-video-previews_regenerate, avatar-video-previews_generate_video |
| 크롤(웹과 소셜) | crawl_scrape, crawl_map, crawl_search, crawl_get, crawl_profile, crawl_feed, crawl_media, crawl_find | crawl_site | 없음 |
| 미디어 | media-imports_get, video_frames_get, video-captions_get, timeline_get | video_inspect, video_frames_create | media-imports_create, video_trim, audio_detach, video_filter, timeline_create, timeline_compose, timeline_audio, trending-videos_search, trending-research_search |
비용이 들지 않는 쓰기는 무엇인가요?
몇몇 쓰기와 유료 도구의 한 가지 모드는 과금되지 않습니다.
crawl_site는 과금되지 않는 쓰기입니다. 이어서 같은 id로jobs_wait를, 그다음crawl_get을 호출하세요.video_frames_create는 과금되지 않습니다.video_inspect의 프로브와 스틸도 과금되지 않으며, 선택 항목인 전사문만 과금됩니다.check_only: true로 호출한video_filter는 과금되지 않는 프로그램 검사입니다.- 유료 도구를
dry_run=true나generation_admission_preview로 미리 보고max_spend_usd로 상한을 거는 방법은 유료 API를 호출하는 AI 에이전트의 안전한 자동화에서 다룹니다.
호스팅 MCP에 없는 도구 이름은 무엇인가요?
tools_list에 없는 이름이라면 다음 중 하나에 해당합니다.
images_create와videos_create. Sume Image 1.0과 Video 1.0은 REST 전용으로 남으며, 둘 다 곧 은퇴합니다(마이그레이션 가이드).get_workflow_instructions,models_explore,media_import_url처럼 Sume 도구가 아닌 이름. 컷아웃은rmbg_create, 소셜 URL 미러는media-imports_create입니다.- 레거시 자막 생성 도구인
video-captions_create와video-caption-overlay_create. 진행 중인 클라이언트를 위해 이름으로 호출할 수는 있지만tools_list에는 없습니다. - Scheduled 실행. MCP 도구가 없습니다.
catalog_list에는 나오지만 대응하는 도구가 없는 모든 것. 카탈로그에는 호스팅 MCP가 감싸지 않는 HTTP 기능도 나올 수 있습니다.
출처
관련 글
작성자 Sume