Terminal
Terminal/Skill
Installs the Profiles toolchain, including profiles-mcp, the pb CLI and editor MCP wiring, and checks the prerequisites first.
By RudderStack
Works with
npx skills add rudderlabs/rudder-agent-skills --skill rudder-profiles-setupSet up the local Profiles toolchain so later skills can discover warehouse metadata, generate YAML, and run pb commands safely.
Check these before anything else:
| Prerequisite | Check | If missing |
|---|---|---|
| Python 3.10+ | which python3 and python3 --version | Install from python.org or system package manager |
| uv | which uv | Install from https://docs.astral.sh/uv/getting-started/installation/ |
| git | which git | Install from git-scm.com or system package manager |
which python3, which uv, which git. If any are missing, explain what to install and stop.git clone https://github.com/rudderlabs/profiles-mcp into a user-approved location. Skip if already cloned..env — The .env file needs RUDDERSTACK_PAT, IS_CLOUD_BASED, and USE_PB_QUERY. Do not ask the user to paste secrets into chat. Instead, instruct them to copy .env.sample to .env and fill in values, or let setup.sh handle it via its interactive env_setup.py step../setup.sh — From the profiles-mcp checkout. This script:
uv if missing,start.sh wrapper,env_setup.py (interactive — prompts for PAT via masked input),.venv,pb CLI,update_mcp_config.py to wire MCP into the user's editor.setup.sh did not handle this, or if the user needs manual config:
claude mcp add profiles -- /path/to/profiles-mcp/.venv/bin/python /path/to/profiles-mcp/server.pyreferences/mcp-config-examples.mdpb version succeeds AND at least one Profiles MCP tool is visible to the agent./rudder-profiles-project to create their first project.profiles-mcp as the source of truth for editor wiring and environment variables./rudder-profiles-project.pb init connection) — that belongs in the project workflow.rudder-mcp-server) — use the existing rudder-mcp-setup skill.setup.sh / env_setup.py), existing shell environment variables, or direct local file edits that do not echo secrets back..env, write placeholder keys only after confirming the file is in .gitignore..env, siteconfig.yaml, or command output that may contain tokens.Setup is complete when all of the following are true:
pb version succeeds.references/mcp-config-examples.md for editor config snippets and post-setup checks.