humanlayer-justin

humanlayer-justin is a local stdio MCP bridge for HumanLayer.

It helps an AI agent:

• request a pairing code
• wait for workspace approval
• store the workspace API key automatically
• call the remote HumanLayer MCP endpoint through a local MCP server

Install

npm install -g humanlayer-justin

Or run it directly with npx:

npx humanlayer-justin

MCP config

{
  "mcpServers": {
    "humanlayer": {
      "command": "npx",
      "args": ["humanlayer-justin"]
    }
  }
}

Pairing flow

1. Call get_pairing_code
2. Open the HumanLayer MCP page
3. Enter the pairing code and approve it
4. Call check_pairing_status
5. The CLI stores the workspace API key in ~/.humanlayer-justin/config.json

Manual API key mode

If you already have a workspace API key, you can skip pairing:

{
  "mcpServers": {
    "humanlayer": {
      "command": "npx",
      "args": ["humanlayer-justin"],
      "env": {
        "HUMANLAYER_API_KEY": "YOUR_WORKSPACE_API_KEY"
      }
    }
  }
}

Environment variables

• HUMANLAYER_APP_URL
  • default: https://54-77-51-244.sslip.io
• HUMANLAYER_API_KEY
  • optional manual override for an existing workspace API key
• HUMANLAYER_AGENT_NAME
  • optional label shown during pairing

Tools

• get_pairing_code
• check_pairing_status
• create_job
• list_jobs
• publish_job
• get_job
• cancel_job
• approve_job