Dashboard →
Agent setup

Connect any autonomous agent

Give Claude Code, Codex, Cursor, or Antigravity the same audited Iris tools: create an identity, receive a managed email address, inspect it, and send only user-approved email.

Do this once
Create a token in Dashboard → Settings. Store it as HUMIRIS_API_KEYin the client's environment or secret manager.

Claude Code

Terminal
claude mcp add iris-identity \
  --env HUMIRIS_API_KEY=hum_sk_live_... \
  -- npx -y https://humiris.com/downloads/humiris-0.3.0.tgz mcp

claude mcp list

Optional project skill:

Terminal
mkdir -p .claude/skills/iris-identity
curl -fsSL https://humiris.com/skill.md \
  -o .claude/skills/iris-identity/SKILL.md

Test prompt: Create an identity and email address for a customer-support agent named Ada Support.

Codex

The Iris Identity plugin bundles the MCP server and the $iris-identity skill. For direct MCP configuration, add:

.codex/config.toml
[mcp_servers.iris-identity]
command = "npx"
args = ["-y", "https://humiris.com/downloads/humiris-0.3.0.tgz", "mcp"]
env_vars = ["HUMIRIS_API_KEY"]

Install the portable skill at repository scope:

Terminal
mkdir -p .agents/skills/iris-identity
curl -fsSL https://humiris.com/skill.md \
  -o .agents/skills/iris-identity/SKILL.md

Restart Codex after changing MCP configuration, then prompt: Use $iris-identity to create an email identity for my research agent.

Cursor

.cursor/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_..."
      }
    }
  }
}

Keep the token out of committed project configuration. Prefer Cursor's user-level MCP settings or an environment-variable reference supported by your deployment.

Antigravity

.agents/mcp_config.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_..."
      }
    }
  }
}

Add the standard skill at .agents/skills/iris-identity/SKILL.md, refresh MCP servers, and use /mcp and /skills to verify discovery.

Acceptance test

Run this sequence in each client:

  1. List existing identities.
  2. Create qa-support with first name QA, last name Support, and email enabled.
  3. Confirm the result includes a unique @humiris.com address.
  4. Draft an email, but verify the agent asks for approval before sending.
  5. Delete the test identity from the dashboard when finished.
Troubleshooting
Run npx -y https://humiris.com/downloads/humiris-0.3.0.tgz doctor --json. A 401 means the token is missing or revoked. A managed-domain provider error belongs to Iris Identity; users should not configure Resend or DNS.