stocklyst

Stocklyst inventory CLI and MCP server for AI assistants.

Install

npm i -g stocklyst

Or use without installing:

npx stocklyst login

Quick start

# Authenticate
stocklyst login

# Check identity
stocklyst whoami

# List inventory
stocklyst items list --format table

# Get dashboard summary
stocklyst report summary

MCP server for Claude Code

After stocklyst login, add to .claude/settings.json:

{
  "mcpServers": {
    "stocklyst": {
      "command": "stocklyst-mcp"
    }
  }
}

No environment variables needed — the MCP bridge reads session tokens from ~/.stocklyst-cli.json automatically.

Authentication

The CLI and MCP bridge share credentials stored in ~/.stocklyst-cli.json.

Auth resolution order:

1. STOCKLYST_BEARER_TOKEN env var
2. Session token from ~/.stocklyst-cli.json (auto-refreshed)
3. STOCKLYST_API_KEY env var (legacy)
4. Fail with guidance to run stocklyst login

Environment variables (optional)

| Variable | Purpose | |----------|---------| | STOCKLYST_BASE_URL | Override API base URL (default: https://stocklyst.com) | | STOCKLYST_REGION | Force API data region header (eu, us, or ap) | | STOCKLYST_AUTH_MODE | Force auto, oauth, bearer, or api-key auth | | STOCKLYST_BEARER_TOKEN | Raw Supabase/JWT bearer token | | STOCKLYST_API_KEY | Legacy API key authentication | | STOCKLYST_SUPABASE_URL | Override Supabase URL | | STOCKLYST_SUPABASE_PUBLISHABLE_KEY | Override Supabase publishable key | | STOCKLYST_COMPANY_ID | Default company context | | STOCKLYST_BRANCH_ID | Default branch context | | STOCKLYST_CLI_CONFIG | Config file path (default: ~/.stocklyst-cli.json) |

License

UNLICENSED