Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

chore(infra): add mw and infra-dev Grafana regions to MCP helpers (#121926)

Michia3d43eb1b4b9
diff --git a/tools/infra-scripts/mcp/README.md b/tools/infra-scripts/mcp/README.md
index 6a22cd65e60d..65ac203003da 100644
--- a/tools/infra-scripts/mcp/README.md
+++ b/tools/infra-scripts/mcp/README.md
@@ -5,7 +5,7 @@ Scripts for connecting AI assistants (Claude Code, Cursor, etc.) to PostHog's in
## Why these scripts exist
PostHog's Grafana instances are reachable directly over Tailscale at plain HTTP hostnames
-(`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, `grafana-internal`).
+(`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, `grafana-internal`, `grafana-mw-dev`, `grafana-mw-prod-us`, `grafana-mw-prod-eu`, `grafana-infra-dev`, `grafana-infra-dev-wl`).
Authentication is handled at the Grafana layer via a service account Bearer token,
which the Grafana MCP server supports natively.
@@ -47,7 +47,7 @@ The wrapper does not add a proxy, tunnel, or authentication bypass.
## Prerequisites
-- **Tailscale** connected, with access to the selected Grafana host (`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, or `grafana-internal`)
+- **Tailscale** connected, with access to the selected Grafana host (`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, `grafana-internal`, `grafana-mw-dev`, `grafana-mw-prod-us`, `grafana-mw-prod-eu`, `grafana-infra-dev`, or `grafana-infra-dev-wl`)
- **mcp-grafana** binary installed
- **macOS** (for Keychain-based token storage) or Linux with environment variables
@@ -92,6 +92,11 @@ grafana-token us <your-us-token>
grafana-token eu <your-eu-token>
grafana-token dev <your-dev-token> # optional
grafana-token internal <your-internal-token> # optional
+grafana-token mw-dev <your-mw-dev-token> # optional
+grafana-token mw-prod-us <your-mw-prod-us-token> # optional
+grafana-token mw-prod-eu <your-mw-prod-eu-token> # optional
+grafana-token infra-dev <your-infra-dev-token> # optional
+grafana-token infra-dev-wl <your-infra-dev-wl-token> # optional
```
### 4. Configure your MCP client
@@ -123,12 +128,17 @@ The wrapper script determines which Grafana region to connect to using (in order
Region → host mapping:
-| Region | Tailscale host |
-| ---------- | ------------------------- |
-| `us` | `http://grafana-prod-us` |
-| `eu` | `http://grafana-prod-eu` |
-| `dev` | `http://grafana-dev` |
-| `internal` | `http://grafana-internal` |
+| Region | Tailscale host |
+| -------------- | ----------------------------- |
+| `us` | `http://grafana-prod-us` |
+| `eu` | `http://grafana-prod-eu` |
+| `dev` | `http://grafana-dev` |
+| `internal` | `http://grafana-internal` |
+| `mw-dev` | `http://grafana-mw-dev` |
+| `mw-prod-us` | `http://grafana-mw-prod-us` |
+| `mw-prod-eu` | `http://grafana-mw-prod-eu` |
+| `infra-dev` | `http://grafana-infra-dev` |
+| `infra-dev-wl` | `http://grafana-infra-dev-wl` |
#### Single-server setup (switching regions manually)
@@ -140,6 +150,7 @@ grafana-region us # Switch to prod-us (us-east-1)
grafana-region eu # Switch to prod-eu (eu-central-1)
grafana-region dev # Switch to dev environment
grafana-region internal # Switch to internal environment
+grafana-region mw-dev # Switch to mw-dev (same for mw-prod-us, mw-prod-eu, infra-dev, infra-dev-wl)
```
**Important: Restart required after switching regions**
@@ -189,6 +200,7 @@ To add internal alongside those servers, add a `grafana-internal` entry to `mcpS
```
Store its token with `grafana-token internal <your-internal-token>`, then restart your MCP client.
+The `mw-dev`, `mw-prod-us`, `mw-prod-eu`, `infra-dev`, and `infra-dev-wl` regions work the same way: set `GRAFANA_REGION` to the region and store its token with `grafana-token <region> <token>`.
Supported regions are explicit so each selection maps to a known host and its own Keychain token.
#### Migrating from single-server to multi-server
@@ -233,7 +245,7 @@ You may want to use a secrets manager or encrypted file for production use.
### Hostname doesn't resolve / connection refused
-The Tailscale hostnames (`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, `grafana-internal`) only resolve when Tailscale is connected to the PostHog tailnet. Check with:
+The Tailscale hostnames (`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, `grafana-internal`, `grafana-mw-*`, `grafana-infra-dev*`) only resolve when Tailscale is connected to the PostHog tailnet. Check with:
```bash
tailscale status
diff --git a/tools/infra-scripts/mcp/grafana-region b/tools/infra-scripts/mcp/grafana-region
index 4c6bf1ce6e83..356a47dd3e8a 100755
--- a/tools/infra-scripts/mcp/grafana-region
+++ b/tools/infra-scripts/mcp/grafana-region
@@ -1,5 +1,5 @@
#!/usr/bin/env bash
-# Switch Grafana MCP server between prod-us, prod-eu, dev, and internal
+# Switch Grafana MCP server between prod-us, prod-eu, dev, internal, mw-dev, mw-prod-us, mw-prod-eu, infra-dev, and infra-dev-wl
#
# Usage:
# grafana-region # Show current region
@@ -7,6 +7,7 @@
# grafana-region eu # Switch to prod-eu
# grafana-region dev # Switch to dev
# grafana-region internal # Switch to internal
+# grafana-region mw-dev # Switch to mw-dev (same for mw-prod-us, mw-prod-eu, infra-dev, infra-dev-wl)
#
# After switching, restart your MCP client (e.g., Claude Code: /exit)
@@ -14,7 +15,7 @@ REGION_FILE="$HOME/.grafana-region"
show_current() {
if [ -f "$REGION_FILE" ] && [ -s "$REGION_FILE" ]; then
- local region=$(head -n1 "$REGION_FILE" | tr -cd '[:alnum:]')
+ local region=$(head -n1 "$REGION_FILE" | tr -cd '[:alnum:]-')
echo "Current Grafana region: $region"
else
echo "Current Grafana region: us (default)"
@@ -22,14 +23,19 @@ show_current() {
}
show_usage() {
- echo "Usage: grafana-region [us|eu|dev|internal]"
+ echo "Usage: grafana-region [us|eu|dev|internal|mw-dev|mw-prod-us|mw-prod-eu|infra-dev|infra-dev-wl]"
echo ""
echo "Commands:"
- echo " (no args) Show current region"
- echo " us Switch to prod-us (us-east-1)"
- echo " eu Switch to prod-eu (eu-central-1)"
- echo " dev Switch to dev (us-east-1)"
- echo " internal Switch to internal"
+ echo " (no args) Show current region"
+ echo " us Switch to prod-us (us-east-1)"
+ echo " eu Switch to prod-eu (eu-central-1)"
+ echo " dev Switch to dev (us-east-1)"
+ echo " internal Switch to internal"
+ echo " mw-dev Switch to mw-dev"
+ echo " mw-prod-us Switch to mw-prod-us"
+ echo " mw-prod-eu Switch to mw-prod-eu"
+ echo " infra-dev Switch to infra-dev"
+ echo " infra-dev-wl Switch to infra-dev-wl"
echo ""
echo "After switching, restart your MCP client to apply the change."
}
@@ -38,7 +44,7 @@ case "${1:-}" in
"")
show_current
;;
- us|eu|dev|internal)
+ us|eu|dev|internal|mw-dev|mw-prod-us|mw-prod-eu|infra-dev|infra-dev-wl)
echo "$1" > "$REGION_FILE"
echo "Switched Grafana region to: $1"
echo ""
@@ -48,7 +54,7 @@ case "${1:-}" in
show_usage
;;
*)
- echo "Error: Invalid region '$1'. Must be 'us', 'eu', 'dev', or 'internal'." >&2
+ echo "Error: Invalid region '$1'. Must be 'us', 'eu', 'dev', 'internal', 'mw-dev', 'mw-prod-us', 'mw-prod-eu', 'infra-dev', or 'infra-dev-wl'." >&2
echo ""
show_usage
exit 1
diff --git a/tools/infra-scripts/mcp/grafana-token b/tools/infra-scripts/mcp/grafana-token
index 8d011c2822a9..5731a43d38aa 100755
--- a/tools/infra-scripts/mcp/grafana-token
+++ b/tools/infra-scripts/mcp/grafana-token
@@ -7,10 +7,12 @@
# grafana-token eu # Show if EU token exists
# grafana-token dev # Show if dev token exists
# grafana-token internal # Show if internal token exists
+# grafana-token mw-dev # Show if mw-dev token exists
# grafana-token us <token> # Set prod-us token
# grafana-token eu <token> # Set prod-eu token
# grafana-token dev <token> # Set dev token
# grafana-token internal <token> # Set internal token
+# grafana-token mw-dev <token> # Set mw-dev token (same for mw-prod-us, mw-prod-eu, infra-dev, infra-dev-wl)
#
# Note: This script requires macOS (uses Keychain).
# On Linux, set the GRAFANA_SERVICE_ACCOUNT_TOKEN environment variable instead.
@@ -51,35 +53,53 @@ show_status() {
else
echo " internal: not configured"
fi
+
+ for region in mw-dev mw-prod-us mw-prod-eu infra-dev infra-dev-wl; do
+ if security find-generic-password -a "$USER" -s "grafana-service-account-token-$region" &>/dev/null; then
+ printf " %-14s configured\n" "$region:"
+ else
+ printf " %-14s not configured\n" "$region:"
+ fi
+ done
}
show_usage() {
- echo "Usage: grafana-token [us|eu|dev|internal] [token]"
+ echo "Usage: grafana-token [us|eu|dev|internal|mw-dev|mw-prod-us|mw-prod-eu|infra-dev|infra-dev-wl] [token]"
echo ""
echo "Commands:"
- echo " (no args) Show token status for all regions"
- echo " us Show if US token is configured"
- echo " eu Show if EU token is configured"
- echo " dev Show if dev token is configured"
- echo " internal Show if internal token is configured"
- echo " us <token> Set prod-us token"
- echo " eu <token> Set prod-eu token"
- echo " dev <token> Set dev token"
- echo " internal <token> Set internal token"
+ echo " (no args) Show token status for all regions"
+ echo " us Show if US token is configured"
+ echo " eu Show if EU token is configured"
+ echo " dev Show if dev token is configured"
+ echo " internal Show if internal token is configured"
+ echo " mw-dev Show if mw-dev token is configured"
+ echo " mw-prod-us Show if mw-prod-us token is configured"
+ echo " mw-prod-eu Show if mw-prod-eu token is configured"
+ echo " infra-dev Show if infra-dev token is configured"
+ echo " infra-dev-wl Show if infra-dev-wl token is configured"
+ echo " us <token> Set prod-us token"
+ echo " eu <token> Set prod-eu token"
+ echo " dev <token> Set dev token"
+ echo " internal <token> Set internal token"
+ echo " mw-dev <token> Set mw-dev token"
+ echo " mw-prod-us <token> Set mw-prod-us token"
+ echo " mw-prod-eu <token> Set mw-prod-eu token"
+ echo " infra-dev <token> Set infra-dev token"
+ echo " infra-dev-wl <token> Set infra-dev-wl token"
echo ""
echo "After setting a token, restart your MCP client to pick it up."
echo ""
echo "To create a service account token in Grafana:"
- echo " 1. Go to Administration > Service accounts"
- echo " 2. Create a new service account or use an existing one"
- echo " 3. Add a token with appropriate permissions"
+ echo " 1. Go to Administration > Service accounts"
+ echo " 2. Create a new service account or use an existing one"
+ echo " 3. Add a token with appropriate permissions"
}
case "${1:-}" in
"")
show_status
;;
- us|eu|dev|internal)
+ us|eu|dev|internal|mw-dev|mw-prod-us|mw-prod-eu|infra-dev|infra-dev-wl)
REGION="$1"
SERVICE="grafana-service-account-token-$REGION"
@@ -119,7 +139,7 @@ case "${1:-}" in
show_usage
;;
*)
- echo "Error: Invalid region '$1'. Must be 'us', 'eu', 'dev', or 'internal'." >&2
+ echo "Error: Invalid region '$1'. Must be 'us', 'eu', 'dev', 'internal', 'mw-dev', 'mw-prod-us', 'mw-prod-eu', 'infra-dev', or 'infra-dev-wl'." >&2
echo ""
show_usage
exit 1
diff --git a/tools/infra-scripts/mcp/mcp-grafana-wrapper.sh b/tools/infra-scripts/mcp/mcp-grafana-wrapper.sh
index 711d1e2ebcd4..3a4aad7e4024 100755
--- a/tools/infra-scripts/mcp/mcp-grafana-wrapper.sh
+++ b/tools/infra-scripts/mcp/mcp-grafana-wrapper.sh
@@ -2,10 +2,13 @@
# Wrapper script for mcp-grafana that connects to PostHog Grafana via Tailscale.
#
# PostHog's Grafana instances are reachable over Tailscale at plain HTTP hostnames
-# (grafana-prod-us, grafana-prod-eu, grafana-dev, grafana-internal). This wrapper looks up a service
+# (grafana-prod-us, grafana-prod-eu, grafana-dev, grafana-internal, grafana-mw-dev,
+# grafana-mw-prod-us, grafana-mw-prod-eu, grafana-infra-dev, grafana-infra-dev-wl). This wrapper looks up a service
# account token from macOS Keychain and hands both the URL and token to mcp-grafana.
#
-# Supports switching between prod-us, prod-eu, dev, and internal via GRAFANA_REGION env var
+# Supports switching between prod-us, prod-eu, dev, internal, mw-dev, mw-prod-us, mw-prod-eu,
+# infra-dev, and infra-dev-wl
+# via GRAFANA_REGION env var
# or ~/.grafana-region file (env var takes precedence). Use `grafana-region <region>`
# to switch, then restart your MCP client.
#
@@ -22,7 +25,7 @@ DEFAULT_REGION="us"
# Read current region (default to us if file missing or empty)
if [ -f "$REGION_FILE" ] && [ -s "$REGION_FILE" ]; then
- CURRENT_REGION=$(head -n1 "$REGION_FILE" | tr -cd '[:alnum:]')
+ CURRENT_REGION=$(head -n1 "$REGION_FILE" | tr -cd '[:alnum:]-')
else
CURRENT_REGION="$DEFAULT_REGION"
fi
@@ -34,12 +37,6 @@ if [ -n "${GRAFANA_REGION:-}" ]; then
REGION_SOURCE="GRAFANA_REGION env var"
fi
-# Validate region
-if [[ "$CURRENT_REGION" != "us" && "$CURRENT_REGION" != "eu" && "$CURRENT_REGION" != "dev" && "$CURRENT_REGION" != "internal" ]]; then
- echo "Error: Invalid region '$CURRENT_REGION' from $REGION_SOURCE. Must be 'us', 'eu', 'dev', or 'internal'." >&2
- exit 1
-fi
-
# Region-specific configuration
case "$CURRENT_REGION" in
us)
@@ -58,6 +55,14 @@ case "$CURRENT_REGION" in
GRAFANA_HOST="grafana-internal"
KEYCHAIN_SERVICE="grafana-service-account-token-internal"
;;
+ mw-dev|mw-prod-us|mw-prod-eu|infra-dev|infra-dev-wl)
+ GRAFANA_HOST="grafana-$CURRENT_REGION"
+ KEYCHAIN_SERVICE="grafana-service-account-token-$CURRENT_REGION"
+ ;;
+ *)
+ echo "Error: Invalid region '$CURRENT_REGION' from $REGION_SOURCE. Must be 'us', 'eu', 'dev', 'internal', 'mw-dev', 'mw-prod-us', 'mw-prod-eu', 'infra-dev', or 'infra-dev-wl'." >&2
+ exit 1
+ ;;
esac
# Find mcp-grafana binary