Z2H Explore MCP

Repo: https://github.com/ram-amit/z2h-explore-mcp (public)

MCP server for campaign-explore looks and dashboards on bigbrain.me. Not Looker (looker-toolbox is a different MCP).

Prerequisites

Requirement	Notes
Cursor, Claude Code (terminal), or Claude Desktop	Not monday browser/workspace Claude
Python 3.10+	macOS Xcode python3 is often 3.9 → brew install python
git	For clone-based install
git config user.name	Becomes your campaign-explore personal folder name

Install (new users)

Copy/paste exactly in Terminal (include --dir .):

git clone https://github.com/ram-amit/z2h-explore-mcp.git ~/z2h-explore-mcp && cd ~/z2h-explore-mcp && ./install-z2h-explore-mcp.sh --dir .

Installer auto-detects your app (--clients auto): uses claude-code when only the claude CLI is installed, cursor when only Cursor is.

Claude Code (terminal) — uses claude mcp add -s user automatically:

./install-z2h-explore-mcp.sh --dir . --clients claude-code

Restart claude, run /mcp, confirm z2h-explore is connected.

Cursor:

./install-z2h-explore-mcp.sh --dir . --clients cursor

Then follow the Next steps printed at the end (restart app, test prompt).

After install

1. Quit the app fully (Cmd+Q), reopen
2. Cursor: Settings → MCP → z2h-explore connected
3. New chat, ask exactly:

list explores in campaign-explore

Expected: Campaign Monitoring, Advanced Analytics, LinkedIn Habu.

Verify install

cd ~/z2h-explore-mcp && ./verify-install.sh

Troubleshooting

Symptom	Fix
Script exits with no output	You ran --dir without a path. Use --dir .
invalid option nameipefail	Don't use curl | bash. Use git clone command above.
MCP not registered (Claude Code)	Re-run: ./install-z2h-explore-mcp.sh --dir . --clients claude-code
MCP not in chat list	Wrong app: use Cursor, Claude Code (claude in terminal), or Claude Desktop — not monday browser Claude
Claude Code: MCP missing	Run /mcp after restarting claude. Check claude mcp list
Only see looker-toolbox	That's Looker. Ask for campaign-explore / z2h-explore
Install finished but no MCP	Re-run without --skip-mcp-json: ./install-z2h-explore-mcp.sh --dir .
Writes fail	Connect VPN or set BIGBRAIN_AUTH_TOKEN in .env

Slack message (team)

campaign-explore MCP for Cursor

paste in Terminal (not a Slack link):

git clone https://github.com/ram-amit/z2h-explore-mcp.git ~/z2h-explore-mcp && cd ~/z2h-explore-mcp && ./install-z2h-explore-mcp.sh --dir .

quit Cursor (Cmd+Q), reopen, test: list explores in campaign-explore

stuck? cd ~/z2h-explore-mcp && ./verify-install.sh and paste output in thread

repo: https://github.com/ram-amit/z2h-explore-mcp

Upgrade

cd ~/z2h-explore-mcp && git pull && ./install-z2h-explore-mcp.sh --dir .

Restart Cursor / Claude Desktop after.

Flags

Flag	Purpose
--dir .	Install path
--clients auto|cursor|claude-code|...	Which app gets MCP config (default: auto)
--python /path/to/python3.12	Force Python for venv
Z2H_EXPLORE_MCP_DIR	Override install folder

Tools

Tool	Purpose
list_explores	Campaign Monitoring, Advanced Analytics, LinkedIn Habu
get_dimensions / get_measures / get_parameters	Field catalog
list_looks / create_look / update_look / delete_look	Saved views
list_dashboards / create_dashboard / update_dashboard	Dashboards
get_z2h_url	Build campaign-explore URLs

Storage default: personal folder (looks/<your name>/, dashboards/<your name>/). Pass shared=true only when explicitly needed.

Notes

• Field catalog cached in ~/.cache/z2h-explore-mcp/
• run_query not in v1; queries run in campaign-explore UI