Dashboard →
Integration

Iris Identity MCP server

A local stdio server that gives compatible autonomous agents typed identity and email tools. It uses the same tested package as the CLI.

Prerequisites

  1. Node.js 20 or later.
  2. An access token from Dashboard → Settings.
  3. The token stored as HUMIRIS_API_KEY in the MCP host—not in prompts or source files.

Generic stdio configuration

mcp.json
{
  "mcpServers": {
    "iris-identity": {
      "command": "npx",
      "args": [
        "-y",
        "https://humiris.com/downloads/humiris-0.3.0.tgz",
        "mcp"
      ],
      "env": {
        "HUMIRIS_API_KEY": "hum_sk_live_..."
      }
    }
  }
}

Tools and safety metadata

iris_list_agentsReadList identities in the authenticated workspace
iris_get_agentReadInspect one identity and its resources
iris_create_identityWriteCreate a persona, profile, and managed email
iris_list_email_addressesReadList addresses assigned to an identity
iris_list_inboxReadList received messages and unread state
iris_read_emailState writeRead one message and mark it read; never opens links
iris_send_emailExternal writeSend explicitly approved outbound email
iris_create_sandbox_phoneSandbox writeCreate a non-operational phone record
iris_create_sandbox_walletSandbox writeCreate a non-operational wallet record
iris_create_sandbox_cardSandbox writeCreate a non-operational card record
Outbound email is an external action
The send tool advertises open-world, non-idempotent write annotations. Host agents should ask for confirmation immediately before invoking it.
Confirmation links require separate approval
Inbox tools return link metadata but do not open links. A host agent should show the sender, destination host, and intended effect before invoking any browser or navigation tool.

Inspect before connecting

Terminal
npm install -g https://humiris.com/downloads/humiris-0.3.0.tgz
iris mcp tools --json
iris doctor --json

Client-specific setup

Use the ready-to-copy configuration for Claude Code, Codex, Cursor, or Antigravity.