Skip to main content
Mcpjungle emits Prometheus-compatible metrics using OpenTelemetry and exposes them at the /metrics endpoint. This gives you a simple operational view of tool traffic and latency across your registered MCP servers.

​
When metrics are enabled

  • In enterprise mode, metrics are enabled by default.
  • In development mode, metrics are disabled by default.
To enable them in development mode: 
export OTEL_ENABLED=true
export OTEL_RESOURCE_ATTRIBUTES=deployment.environment.name=development

mcpjungle start
You can also set OTEL_ENABLED=false in enterprise mode if you explicitly want to disable metrics, but that is not the recommended operating posture for shared deployments.

​
Metrics endpoint

Once Mcpjungle is running with telemetry enabled: 
curl http://localhost:8080/metrics
The response uses standard Prometheus text exposition format.

​
Available metrics

MetricTypeDescription
mcpjungle_tool_calls_ratio_totalCounterTotal number of tool calls handled by Mcpjungle.
mcpjungle_tool_call_latency_secondsHistogramLatency for tool calls, in seconds.
Both metrics include these labels:
LabelDescription
mcp_server_nameName of the upstream MCP server that owns the tool.
tool_nameCanonical tool name, for example calculator__add.
outcomesuccess or error.

​
Example output

# HELP mcpjungle_tool_calls_ratio_total Total number of tool calls
# TYPE mcpjungle_tool_calls_ratio_total counter
mcpjungle_tool_calls_ratio_total{mcp_server_name="calculator",tool_name="add",outcome="success"} 42

# HELP mcpjungle_tool_call_latency_seconds Latency of tool calls in seconds
# TYPE mcpjungle_tool_call_latency_seconds histogram
mcpjungle_tool_call_latency_seconds_count{mcp_server_name="calculator",tool_name="add",outcome="success"} 42

​
Prometheus

The production Compose path ships with a Prometheus service already configured to scrape Mcpjungle: 
scrape_configs:
  - job_name: 'mcpjungle'
    static_configs:
      - targets: ['mcpjungle:8080']
    metrics_path: '/metrics'
    scrape_interval: 15s
If you run your own Prometheus stack, scrape the gateway’s /metrics endpoint directly.

​
Feedback

If you want to see more metrics or have feedback on the current ones, please share your thoughts in the GitHub discussions or open an Issue.

Production deployment

Run Mcpjungle in enterprise mode with the right operational defaults.

Database

Back your shared deployment with PostgreSQL.

Governance overview

Understand the enterprise operating model around authentication and client access.

Reference: environment variables

See the full environment variable reference for telemetry and deployment tuning.