Skip to main content
Tool groups let you expose a curated subset of tools through their own MCP endpoint. They are useful when different agents or teams should only see a narrow tool surface instead of the full gateway. For the conceptual model and endpoint behavior, see Tool groups.
Treat mcpjungle create group --help, get group --help, and update group --help as the authoritative source for current flags. This page focuses on the important workflows and config shape.

create group

Creates a new tool group from a JSON configuration file.
Minimal example:
Fields:
  • name: unique group name
  • description: optional description
  • included_tools: explicit tool names to include
  • included_servers: include all tools from these servers
  • excluded_tools: remove individual tools from the final set
Example:
After creation, mcpjungle serves the group on:
  • /v0/groups/{group-name}/mcp
  • /v0/groups/{group-name}/sse
  • /v0/groups/{group-name}/message
SSE support exists for compatibility, but it is a deprecated transport with limited support in mcpjungle. Prefer the streamable HTTP endpoint.
Use get group for the full configuration and endpoint URLs.

get group

Shows the stored definition of a tool group and the endpoint URLs it exposes.
Example:
get group shows the configured definition. If a tool in that definition is later disabled globally or removed entirely, it will still appear here even though it is no longer usable through the group endpoint.

update group

Replaces the configuration of an existing group with a new JSON file.
Example:
The CLI reports what changed, including added or removed tools, servers, and exclusions.
Updating a group takes effect immediately. Any tools removed from the configuration stop being available through that group’s endpoint right away.

delete group

Deletes a tool group and removes its endpoint.
Example:
Deleting a group does not delete the underlying tools or servers. It only removes the group definition and its dedicated endpoints.
As soon as you delete a group, its MCP endpoint is no longer available. Any mcp clients still relying on this endpoint will no longer be able to access it.
Two related commands are often useful when working with groups:
Use Tool groups for the higher-level workflow and operational guidance.