partnerstack-cli

CLI and MCP server for the PartnerStack API v2. 44 commands across 15 groups. Every endpoint is available as both a CLI subcommand and an MCP tool.

Installation

npm install -g partnerstack-cli

Authentication

# Option 1: Environment variable (recommended for agents)
export PARTNERSTACK_API_KEY="your_api_key"

# Option 2: Login command (stores in ~/.partnerstack-cli/config.json)
partnerstack login --api-key "your_api_key"

# Option 3: Per-command flag
partnerstack partnerships list --api-key "your_api_key"

Get your API key: Partner Dashboard → Settings → API → Reveal

Usage

partnerstack partnerships list --pretty
partnerstack customers create --customer-key "user-123" --partner-key <key> --email "[email protected]"
partnerstack transactions create --customer-email "[email protected]" --amount 9900
partnerstack leads convert <lead-key> --customer-key "user-123"

MCP Integration

Add to your MCP config:

{
  "mcpServers": {
    "partnerstack": {
      "command": "node",
      "args": ["/path/to/dist/mcp.js"],
      "env": { "PARTNERSTACK_API_KEY": "your_key" }
    }
  }
}

Commands

| Group | Subcommands | |---|---| | partnerships | list, get, update, delete, add-member, tag | | customers | list, get, create, update, delete | | leads | list, get, create, update, delete, convert | | deals | list, get, create, update, delete, convert | | transactions | list, create, delete | | actions | list, create, delete | | rewards | list, create | | groups | list | | links | list | | applications | create | | form-templates | list | | webhooks | list, get, create, update, delete | | stats | export | | marketplace | list-programs, get-program | | payouts | list |

Output

All output is JSON. Use --pretty for human-readable output, --fields to filter fields, --quiet for exit-code-only.

partnerstack customers list --fields "key,email,partnership_key"
partnerstack transactions list --pretty --limit 10

See AGENTS.md for the complete agent guide.