Skip to main content
Glama
ram-amit

Z2H Explore MCP

by ram-amit
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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

Related MCP server: Amazon Ads Manager MCP Server

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers