| name | maco |
| description | Use maco to access many MCP tools through a compact code-execution interface. Trigger when users want to run or configure maco up, use MCP tools through bash/code_execute, run multi-step MCP workflows in Python, filter/join/page large MCP responses locally, or reduce MCP tool-schema context. |
maco
maco lets agents use many upstream MCP tools through a small code-execution surface. It follows the code-execution-with-MCP pattern: keep live MCP sessions and large schemas behind a gateway, then use Python for multi-step work without loading every tool definition into context.
Primary interface: maco up
Prefer MCP mode whenever possible. maco up starts a managed gateway for the upstream MCP servers and exposes one Streamable HTTP MCP endpoint with two tools:
bash(command, timeout?) — inspect generated wrappers or run small non-interactive probes in the sandbox.code_execute(code, filename?, args?, timeout?) — run Python that imports generated MCP tools.
Agents thrive on discovery with rg and fd, so maco gives them bash access to navigate the tool interface as a real filesystem before writing code.
Start it from this repository/skill directory or an installed package environment with:
uv run maco up --config mcp.json --provider local
Defaults:
- Config:
mcp.json
- HTTP MCP endpoint:
http://127.0.0.1:8789/mcp
- Generated host workspace:
.maco
- Sandbox SDK:
/workspace/macosdk/tools
- Sandbox providers:
local, docker,
