universal-tool-calling-protocol/code-mode

npm install @utcp/code-mode
For shell agents (preferred): npx -y @utcp/code-mode-cli prompt (self-configuring CLI, no server needed)
For MCP-only clients: {"mcpServers":{"code-mode":{"command":"npx","args":["@utcp/code-mode-mcp"],"env":{"UTCP_CONFIG_FILE":"/path/to/.utcp_config.json"}}}
Transport plugins: npm install @utcp/mcp (or @utcp/http, @utcp/text, etc.)

Usage

• •const client = await CodeModeUtcpClient.create(); await client.registerManual({name:"github", call_template_type:"mcp", config:{...}});
• •const { result, logs } = await client.callToolChain(`...code...`, timeoutMs);
• •Discover tools instead of loading 500 definitions: await client.searchTools("github pull request")
• •CLI: npx -y @utcp/code-mode-cli search "<task>" / run / login (interactive OAuth)

Key features

• ✓Code-mode execution: single TypeScript code block replaces 15+ traditional tool calls (67-88% faster per independent benchmark)
• ✓Progressive tool discovery and auto-generated TypeScript interfaces for IDE IntelliSense
• ✓Multi-protocol tool chains mixing MCP, HTTP/REST (with auto-discovery), File (JSON/YAML), and CLI tools in one execution
• ✓Enterprise-ready: Node.js VM sandboxing, no filesystem/network access by default, configurable timeouts, full console log capture
• ✓Ships AGENT_PROMPT_TEMPLATE for any AI framework plus a ready-to-use MCP server and a self-configuring utcp CLI

Best for

Coding agents (Claude Code, Cursor, Codex, Claude Cowork) that want fewer, larger tool executions with lower token cost and context bloat.

Caveats

• ⚠Cost-savings claims ($9,536/year at 1,000 scenarios/day) come from an independent Python benchmark study, not first-party
• ⚠Prefer the CLI when the agent has shell access; the MCP server is for MCP-only clients like Claude Desktop
• ⚠License: MPL-2.0