Signals CLI
Max CLI is a command-line tool for developers and AI agents to interact with the Max API, enabling lead discovery, subscription management, and workflow automation from the terminal. It solves the problem of manually monitoring sources like LinkedIn and funding databases for new leads by providing programmatic access. It is designed for developers and AI agents who want to integrate lead intelligence into their workflows.
✨ Key features
- Interactive login and API key management
- List and manage businesses with ICP
- Create and manage signal subscriptions
- List, get, and delete leads with JSON output
- Register webhooks for real-time lead notifications
- All commands output JSON for easy parsing
🎯 Use cases
- Automate lead generation from LinkedIn company engagers
- Set up real-time notifications for new leads via webhooks
- Integrate lead discovery into AI agent workflows
- Manage multiple businesses and their ideal customer profiles
📦 Installation
🧰 Requirements: Requires Node.js and npm, a Max account with an API key (from Settings > API Keys), and optionally a business ID for lead/subscription/webhook commands.
npm install -g sortlist-max-cli
For AI agents, install the Max skill:
npx skills add sortlist/max-cli
🚀 Usage
max loginmax businesses:create --website https://acme.commax signals:listmax subscriptions:create --business 1 \
--signal linkedin-company-engagers \
--name "Acme Engagers" \
--config '{"linkedin_url":"https://www.linkedin.com/company/acme/"}'max leads:list --business 1⚠️ Good to know
The CLI is subject to rate limiting (60 requests per minute) and requires a valid API key; leads are soft-deleted, and some commands require a business ID.
❓ FAQ
How do I authenticate?
Run max login and enter your API key, or set the MAX_API_KEY environment variable, which takes priority over saved config.
What output format does the CLI use?
All commands output JSON, making it easy to parse with jq or consume by AI agents.
How do I get real-time notifications for new leads?
Create a webhook with max webhooks:create --business <id> --url <your-url> --secret <secret> to receive HTTP POST requests when new leads are discovered.
What are the exit codes and HTTP statuses?
Exit code 0 means success, 1 means error. HTTP 401 indicates missing/invalid API key, 404 not found, 422 validation error, and 429 rate limit exceeded.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.