> ## Documentation Index > Fetch the complete documentation index at: https://docs.bland.ai/llms.txt > Use this file to discover all available pages before exploring further. # Command Line Interface > Manage your Bland account from the terminal: make calls, build and test pathways, configure phone numbers, and more. Manage your entire Bland account from the terminal: make calls, build and test pathways, configure phone numbers, and more. **Install via NPM:** [`bland-cli`](https://www.npmjs.com/package/bland-cli) ```bash theme={null} # Install globally npm install -g bland-cli # Or run without installing npx bland-cli ``` **Requirements:** Node.js 18+ ## Getting started ```bash theme={null} bland auth login --key YOUR_API_KEY ``` Or set the environment variable: ```bash theme={null} export BLAND_API_KEY=your_key_here ``` ```bash theme={null} # Check your account bland auth whoami # Make an outbound call bland call send +15551234567 --task "Ask about demo" --voice nat --wait # List recent calls bland call list ``` ## What you can do Make outbound calls with customizable voices, tasks, and pathways. View and analyze call history directly from the terminal. ```bash theme={null} bland call send +15551234567 --task "Schedule a follow-up" --voice maya bland call list bland call get bland call stop bland call events bland call recording bland call analyze ``` Create and manage conversational pathways as YAML files. Sync local YAML with the Bland API, run interactive tests, and automate test cases. ```bash theme={null} bland pathway init ./my-pathway --name "Customer Support" bland pathway push ./my-pathway bland pathway pull ./my-pathway bland pathway diff ./my-pathway bland pathway validate ./my-pathway bland pathway watch ./my-pathway bland pathway list bland pathway get bland pathway create bland pathway chat --verbose bland pathway test bland pathway simulate bland pathway promote bland pathway versions bland pathway generate --description "..." ``` Purchase, configure, and release phone numbers from your terminal. ```bash theme={null} bland number list bland number buy --area-code 415 bland number release bland number update bland number configure ``` Browse available voices and synthesize audio samples. ```bash theme={null} bland voice list bland voice speak "Hello there" --voice nat -o hello.mp3 ``` Create and manage personas for your agents, including versioning and knowledge gap tracking. ```bash theme={null} bland persona list bland persona get bland persona create bland persona update bland persona delete bland persona promote bland persona reset-draft bland persona gaps ``` Create and manage custom tools that your agents can call during conversations. ```bash theme={null} bland tool list bland tool get bland tool create bland tool update bland tool delete bland tool test --input '{"key": "value"}' ``` Create and manage knowledge bases, including populating them via web scraping. ```bash theme={null} bland knowledge list bland knowledge create bland knowledge scrape --urls https://example.com bland knowledge status bland knowledge delete ``` Automate large-scale outbound call campaigns. ```bash theme={null} bland batch create --file contacts.csv --pathway bland batch list bland batch get bland batch stop ``` Send and manage SMS conversations through the CLI. ```bash theme={null} bland sms send +15551234567 --message "Hello!" bland sms conversations bland sms get ``` Manage web agents. ```bash theme={null} bland agent list bland agent get bland agent create bland agent update bland agent delete ``` Configure guard rails for your agents. ```bash theme={null} bland guard list bland guard create bland guard delete ``` Set up monitoring alarms and manage secrets. ```bash theme={null} bland alarm list bland alarm create bland alarm delete bland secret list bland secret set bland secret delete ``` Manage releases and embeddable widgets. ```bash theme={null} bland release list bland release create bland release promote bland widget list bland widget create bland widget delete ``` Generate TTS audio, analyze audio files, and manage SIP endpoints. ```bash theme={null} bland audio generate --voice nat -o output.mp3 bland audio analyze bland sip discover ``` Run and manage automated pathway test cases. ```bash theme={null} bland eval run bland eval list bland eval get bland eval add ``` ## Local Webhook Development Forward Bland webhooks to your local dev server without ngrok: ```bash theme={null} # Terminal 1: your app node server.js # Terminal 2: bland webhook forwarder bland listen --forward-to http://localhost:3000/webhook ``` ## MCP Server The CLI includes an [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server, which lets AI coding tools like Claude Code and Cursor interact with your Bland account through natural language. ```bash theme={null} bland mcp # Or with SSE transport bland mcp --transport sse --port 3100 ``` ### Claude Code Setup Add to your Claude Code config: ```json theme={null} { "mcpServers": { "bland": { "command": "npx", "args": ["bland-cli", "mcp"] } } } ``` Once running, AI tools can make calls, manage pathways, check your balance, and more without leaving your development environment. ## JSON Output Every list and get command supports `--json` for piping to `jq` or scripts: ```bash theme={null} bland pathway list --json | jq '.[].id' bland call get --json | jq '.transcripts' bland number list --json | jq 'length' ``` ## Environment Variables | Variable | Purpose | | ---------------- | ---------------------------------------------- | | `BLAND_API_KEY` | API key (overrides stored profile) | | `BLAND_BASE_URL` | API base URL (default: `https://api.bland.ai`) | ## Profiles The CLI supports multiple profiles for managing different API keys or organizations. ```bash theme={null} bland auth login --key sk-... # Add a profile bland auth switch # Switch between profiles bland auth profiles # List all profiles bland auth logout # Clear credentials ``` Profiles are stored at `~/.config/bland-cli/config.json`. You can also override the API key per-command with `BLAND_API_KEY`. *** Docs for agents: [llms.txt](/llms.txt)