도구 API

사용 가능한 도구 목록

GET /api/tools

POST /api/tools/:name/execute

{
  "parameters": {
    "url": "https://example.com"
  }
}

Tool	Description
`browser`	Web browsing and scraping
`file_system`	File read/write operations
`terminal`	Shell command execution
`code_execute`	Code execution in sandbox
`grep_tool`	Ripgrep-powered regex content search (three-tier: ripgrep → mmap → Python), path-grouped densified output (auto-deduplicates paths when ≥5 matches, saving 18-39% tokens), ReDoS protection, non-code file auto-capping
`glob_tool`	File path pattern search under the workspace
`@codebase` mention	Lightweight workspace file/extension overview injected into the user message (use with grep/glob for exploration)
`web_search`	Multi-engine search with BM25/Reranker filtering — returns cleaned, deduplicated snippets
`render_ui`	Declarative in-chat UI (23 A2UI components). Turn1 ~223 tok; full props in `.agent/docs/A2UI_REFERENCE.md` (auto-seeded when enabled). Fail-closed on unknown types
`update_ui_data`	Incremental `data_update` SSE for live panels (progress, metrics, task lists). Deep-merges `data` model — nested fields update without wiping sibling keys. Mounted with `render_ui` when Interactive UI is enabled
`todo_write`	Structured task planning for multi-step objectives. Hard-enforced MAX_TODOS=20 limit prevents over-planning; single `in_progress` concurrency keeps execution focused. Violations auto-corrected with LLM feedback. Opt-in via Planning toggle or auto-enabled on resume when existing todos detected

Scenario	Enabled by default	Opt-in
General chat	`web_search` + `memory`	—
Coding / files	Enable file_ops → `glob_tool` + `grep_tool` + file_* mount immediately (Claude Code–style eager, not discover-deferred)	`code_execute` (bash)
MCP / bound skills	—	`discover_capability_tool` → `skill_select_tool` searches already-bound library (`<BoundSkills>`)
External skill marketplace	—	`skill_discovery_tool` search/install from GitHub/skills.sh; Settings Discover tab also available
Skill hygiene	WebUI Curator sweep	—

MCP을 통해 연결된 외부 도구는 내장 도구와 함께 자동으로 등록됩니다. MCP 도구 이름은 네임스페이스 격리를 위해 내부적으로 mcp__{server}__{tool} 접두사가 붙습니다. API은 접두사가 붙은 이름과 원래 이름을 모두 허용합니다.

MCP 서버를 여러 도구와 연결하면 Myrm은(는) 전체 도구 액세스를 유지하면서 토큰 사용을 최소화하는 최적의 라우팅 전략을 자동으로 선택합니다.

Route	Condition	Behavior	User Experience
Direct	Server tools ≤ threshold AND within aggregate budget	Full tool schemas loaded upfront	Zero-latency tool calls
PTC / Skill	Server tools > threshold OR aggregate budget exceeded	Wrapped as a Skill (`skill_search` → `skill_select` → PTC)	On-demand discovery via skill search

50개 도구 MCP 서버를 연결해도 Turn1 프롬프트가 부풀려지지 않습니다. 대규모 서버는 스킬로 강등되고 요청 시 검색됩니다. Direct MCP 도구는 UI에 실제 이름을 표시합니다.

보안 규칙(ALLOW/ASK/DENY)은 직접 MCP 도구와 Skill/PTC 호출 모두에 적용됩니다. mcp__gmail__send_email에 대한 도구별 DENY 규칙은 기술 경로를 통해 우회할 수 없습니다.

POST /api/tools/mcp__github__search_repos/execute

에이전트별 도구 필터링은 MCP 서버 구성의 tool_include / tool_exclude을 통해 지원됩니다.

{
  "tool_include": ["search_repos", "get_issue"],
  "tool_exclude": ["delete_repo"]
}

자세한 내용은 MCP 통합 > 도구 필터링을 참조하세요.