Integration

Iris Identity CLI

A Node.js 20+ command-line client for creating identities, inspecting resources, running diagnostics, sending approved email, and starting the MCP server.

Install

Terminal

npm install -g https://humiris.com/downloads/humiris-0.3.0.tgz
iris --version
# 0.3.0

npm registry status

This release has not been published to the npm registry yet. The versioned release artifact above is the currently tested installation path.

Authenticate

Create a revocable token in Dashboard → Settings. The configuration file is stored with owner-only permissions.

Terminal

iris auth login --token hum_sk_live_...
iris auth status
iris doctor --json

For CI and agent hosts, prefer a secret environment variable:

Terminal

export HUMIRIS_API_KEY=hum_sk_live_...
iris doctor

Create and inspect identities

Terminal

iris agents create alex-sdr \
  --first-name Alex \
  --last-name Rivera \
  --role SDR \
  --json

iris agents list --json
iris agents get AGENT_ID --json
iris email list AGENT_ID --json

Default address

Email creation is enabled by default and allocates a unique @humiris.com address. Use --no-email only when the identity must not send email.

Send approved outbound email

Terminal

iris email send AGENT_ID \
  --to recipient@example.com \
  --subject "Approved subject" \
  --body "Approved body" \
  --json

The CLI exits non-zero and returns the provider error when sending fails. It never reports delivery optimistically.

Read received email

Terminal

iris inbox list AGENT_ID --unread --limit 50 --json
iris inbox read AGENT_ID MESSAGE_ID --json

Reading a message marks it read and returns its plain-text body, attachment metadata, and extracted links. The CLI does not open links.

MCP and automation

Terminal

iris mcp tools --json
iris mcp

The MCP server writes protocol frames to stdout and keeps diagnostics off the protocol stream. See the MCP guide.

Sandbox-only resources

Terminal

iris provision phone AGENT_ID --sandbox --country US
iris provision wallet AGENT_ID --sandbox --chain ethereum
iris provision card AGENT_ID --sandbox --network visa

Not operational

These records cannot receive SMS, make calls or payments, or sign transactions.