Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mcpjungle.com/llms.txt

Use this file to discover all available pages before exploring further.

This page covers the day-to-day CLI commands used after the server is running: registering upstream MCP servers, inspecting what they expose, invoking tools, reading prompts and resources, and controlling visibility. Use the dedicated guides for deeper workflows:
Treat mcpjungle <command> --help as the authoritative source for the currently supported flags. This page keeps the higher-value workflows and examples.

​
register

Registers an upstream MCP server in mcpjungle. Once registration succeeds, the server’s tools, prompts, and resources become available through the gateway. 
mcpjungle register [flags]
For streamable HTTP servers, you can use flags directly: 
mcpjungle register --name context7 --url https://mcp.context7.com/mcp
You can also pass a static bearer token for upstream authentication: 
mcpjungle register --name github --url https://api.githubcopilot.com/mcp \
  --bearer-token ghp_your_token_here
For stdio and sse servers, use a JSON config file: 
mcpjungle register --conf ./filesystem.json

​
Common flags

​
--name
string
Unique server name. Required when not using --conf.
​
--url
string
URL of a streamable HTTP MCP server. Required when registering an HTTP server without --conf.
​
--description
string
Optional human-readable description.
​
--bearer-token
string
Static bearer token forwarded to the upstream HTTP server.
​
--force
boolean
default:"false"
Deregister an existing server with the same name, then register the new one.
​
-c / --conf
string
Path to a JSON config file. Required for stdio and sse servers.

​
Minimal config examples

Streamable HTTP: 
{
  "name": "calculator",
  "transport": "streamable_http",
  "description": "Basic math tools",
  "url": "http://127.0.0.1:8000/mcp",
  "session_mode": "stateless"
}
STDIO: 
{
  "name": "filesystem",
  "transport": "stdio",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
  "session_mode": "stateful"
}
For the full config fields, session_mode, environment-variable placeholders, and transport-specific notes, use:
Server names must be unique across mcpjungle and must not contain whitespace, special characters, or consecutive underscores (__).

​
deregister

Removes a registered MCP server and all of its tools, prompts, and resources from the gateway. 
mcpjungle deregister <server-name>
Example: 
mcpjungle deregister context7
Deregistering a server removes its tools, prompts, and resources immediately. Any connected MCP client relying on them will start failing.

​
list

Lists the entities currently registered in mcpjungle. 
mcpjungle list <subcommand> [flags]

​
list servers

Lists registered MCP servers and their transport details. 
mcpjungle list servers

​
list tools

Lists tools across the gateway, or filters them by server or tool group. 
mcpjungle list tools [--server <name>]
mcpjungle list tools [--group <name>]
​
--server
string
Filter tools to a specific registered server.
​
--group
string
Filter tools to those currently active in a tool group.
--server and --group cannot be combined. list tools --group only shows tools that are currently active. Use get group to inspect the full configured group definition.

​
list prompts

Lists prompts across all servers or from one server. 
mcpjungle list prompts
mcpjungle list prompts --server github

​
list resources

Lists resources across all servers or from one server. 
mcpjungle list resources
mcpjungle list resources --server mintlify-mcpjungle

​
list groups

Lists tool groups. 
mcpjungle list groups

​
Common examples

# List all tools
mcpjungle list tools

# List tools from one server
mcpjungle list tools --server github

# List tools currently active in a group
mcpjungle list tools --group engineering-tools

# List prompts from one server
mcpjungle list prompts --server github

# List resources from one server
mcpjungle list resources --server mintlify-mcpjungle

​
usage

Shows the input schema for a tool before you invoke it. 
mcpjungle usage <tool-name>
Example: 
mcpjungle usage github__create_issue
The output includes the tool description, argument types, required fields, and any JSON-schema constraints exposed by the upstream MCP server.

​
invoke

Calls a tool directly through mcpjungle. 
mcpjungle invoke <tool-name> [flags]

​
Flags

​
--input
string
default:"{}"
JSON object of input arguments passed to the tool.
​
--group
string
Invoke the tool within a tool group’s context. The tool must be available in that group.

​
Examples

# Invoke a tool with no input
mcpjungle invoke github__list_repos

# Invoke a tool with JSON input
mcpjungle invoke github__create_issue \
  --input '{"owner": "myorg", "repo": "myrepo", "title": "Bug report"}'

# Invoke within a tool group
mcpjungle invoke github__create_issue \
  --input '{"owner": "myorg", "repo": "myrepo", "title": "Bug"}' \
  --group engineering-tools
Text responses are printed to stdout. If the response contains images, audio, or binary resources, the CLI may save files in the current working directory.

​
enable

Enables tools, prompts, or an entire server globally. 
mcpjungle enable <subcommand> <name>
Supported forms:
  • mcpjungle enable tool <name>
  • mcpjungle enable prompt <name>
  • mcpjungle enable server <name>
Examples: 
mcpjungle enable tool github__create_issue
mcpjungle enable tool github
mcpjungle enable prompt github
mcpjungle enable server github
The legacy form mcpjungle enable <name> still works for backward compatibility, but enable tool <name> or enable server <name> is preferred.

​
disable

Disables tools, prompts, or an entire server globally. 
mcpjungle disable <subcommand> <name>
Supported forms:
  • mcpjungle disable tool <name>
  • mcpjungle disable prompt <name>
  • mcpjungle disable server <name>
Examples: 
mcpjungle disable tool github__delete_repo
mcpjungle disable tool github
mcpjungle disable prompt github
mcpjungle disable server github
The legacy form mcpjungle disable <name> still works for backward compatibility, but only maps to tool disabling behavior.

​
get prompt

Retrieves a prompt template and optionally renders it with arguments. 
mcpjungle get prompt <prompt-name> [--arg key=value ...]
Example: 
mcpjungle get prompt github__code-review \
  --arg code="def hello(): print('world')" \
  --arg language="python"
The output shows the generated structured messages returned by the upstream MCP server.

​
get resource

Retrieves resource metadata, or reads the resource contents. 
mcpjungle get resource <uri>
mcpjungle get resource --read <uri>
Examples: 
# View metadata
mcpjungle get resource mcpj://res/mintlify-mcpjungle/bWludGxpZnk6Ly9za2lsbHMvbWNwanVuZ2xl

# Read the contents
mcpjungle get resource --read mcpj://res/mintlify-mcpjungle/bWludGxpZnk6Ly9za2lsbHMvbWNwanVuZ2xl
With --read, text content is printed inline. Blob content may be decoded and written to a file in the current working directory.