Integrations

MCP (Claude Code)

Add Iris as a Model Context Protocol (MCP) server in Claude Code. This gives Claude direct access to agent identity tools: create agents, send emails, check SMS inboxes, manage wallets, and more, all from natural language.

How to add as MCP server

Register the Iris MCP server with a single command. This makes all Iris tools available to Claude Code in your current project or globally.

bash

# Add Iris as an MCP server (project scope)
claude mcp add iris --url https://identity.irislabx.com/mcp

# Or add globally (available in all projects)
claude mcp add iris --url https://identity.irislabx.com/mcp --global

You will be prompted to provide your Iris API key on first use. The key is stored securely and used to authenticate all MCP tool calls.

bash

# Verify the MCP server is connected
claude mcp list

# Output:
# NAME       URL                          STATUS
# iris    https://identity.irislabx.com/mcp      connected

Available tools and resources

Once connected, Claude Code gains access to the following Iris tools:

iris_create_agentCreate a new agent with specified identity primitives

iris_list_agentsList all agents in the workspace

iris_send_emailSend an email from an agent

iris_read_inboxRead an agent email inbox

iris_send_smsSend an SMS from an agent phone number

iris_read_smsRead received SMS messages

iris_wallet_sendSend a crypto transaction

iris_wallet_balanceCheck wallet balances

iris_computer_execExecute a command on the agent VPS

iris_browser_navigateNavigate the agent browser to a URL

Example usage

Once the MCP server is connected, you can use natural language in Claude Code to interact with Iris. Here are some example prompts and what they do:

text

> "Create a new agent called research-bot with email and a browser"

Claude will call iris_create_agent with:
{
  "slug": "research-bot",
  "identity": {
    "email": true,
    "browser": true
  }
}

> "Send an email from research-bot to team@acme.com with a summary of today's findings"

Claude will call iris_send_email with the agent slug, recipient, and
a composed email body.

> "Check if research-bot has received any new emails"

Claude will call iris_read_inbox and summarize the results.

> "What's the ETH balance of defi-agent's wallet?"

Claude will call iris_wallet_balance and report the balance.

Configuration options

You can pass additional configuration when adding the MCP server:

bash

# Add with a specific API key
claude mcp add iris \
  --url https://identity.irislabx.com/mcp \
  --env IRIS_API_KEY=hum_sk_live_...

# Remove the MCP server
claude mcp remove iris

Next steps

Install the Iris CLI for terminal-based management. Generate an API Key if you have not already. See the API Reference for the full list of available endpoints.