Execute TypeScript/JavaScript code to perform MCP operations efficiently.

Token Savings: 90-98% vs individual tool calls. Batch operations in a single execution.

API: mcp.server('name').call('tool', params) | mcp.searchTools('query') | mcp.log('msg')

Example: const files = await mcp.filesystem.call('list_directory', { path: '/src' }); return files;

Use passthrough_call only for debugging - it has HIGH token cost.

List all MCP servers connected through MCP Executor.

Search for available tools across all connected MCP servers.

Get detailed aggregated metrics for the current session including token savings, performance, and usage patterns.

Switch between operation modes:

• execution: All requests go through the code executor (default, maximum token savings)

• passthrough: Direct tool calls without code execution (for debugging/comparison)

• hybrid: Automatic selection based on task complexity

Reload MCP server configurations. Useful after modifying claude_desktop_config.json.

Get detailed information about MCP Executor capabilities and configuration.

Analyse how a task would be handled in different modes. Returns estimated token usage and approach for each mode.

⚠️ DEBUGGING TOOL - Direct MCP tool call. HIGH TOKEN COST (10-100x vs execute_code).

Only use for debugging raw tool input/output. Use execute_code for all normal operations.

Web search via Brave Search API. Uses 90% fewer tokens than native WebSearch.

Routes to brave-search MCP server internally. Requires brave-search server to be configured.

Add a new MCP server to conductor config and connect immediately.

Saves the server configuration to ~/.mcp-conductor.json and triggers a reload. Use this to dynamically add servers without restarting Claude.

Remove an MCP server from conductor config and disconnect it.

Removes the server configuration from ~/.mcp-conductor.json and triggers a reload. Use this to dynamically remove servers without restarting Claude.

Update an existing MCP server's configuration (command, args, or env vars).

Use this to update API keys or other settings without removing and re-adding the server. Triggers a reload to apply changes immediately.

Returns live memory usage and resource counts for the conductor process. Use this to diagnose memory issues.

Predict the token cost and latency of executing code based on historical samples for similar call patterns.

Return the top-K tool call paths by total latency or p99 within a rolling time window.

Start recording all tool calls in the current session to a replay journal.

Stop an active recording session and finalise the replay journal.

Replay a recorded session, optionally applying modifications. Detects divergence when replayed result differs from recorded result.

Import MCP servers from Claude config files into ~/.mcp-conductor.json.

Reads ~/.claude/settings.json, ~/Library/Application Support/Claude/claude_desktop_config.json and other standard paths. Shows a diff of what will be imported. On confirm=true, copies entries into the conductor config and writes .bak backups of each source file. Optionally strips the imported servers from their source configs.

Transiently connect to a named MCP server from conductor config, list its tools and measure latency. Does NOT persist the connection or register the server. The server must be present in ~/.mcp-conductor.json.

Diagnose a registered MCP server: process health, connection status, recent errors, reconnect attempts, last successful call, and registry state. Returns actionable information about why a server may be failing.

Apply the X1 routing heuristic to one or all configured servers. Servers whose names match lightweight-payload patterns (search, calendar, email, etc.) are recommended as "passthrough". All others default to "execute_code" (safe default). Use apply=true to write the hints into conductor config.

Generate a mcpServers JSON block that points Claude back at mcp-conductor stdio. This is the rollback path: paste the output into your Claude Desktop or Claude Code config to restore direct connectivity. Formats: "claude-desktop" (full wrapper object), "claude-code" (flat mcpServers), "raw" (inner object only).