Integrations

MCP (Claude Code)

Add Humiris 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 Humiris MCP server with a single command. This makes all Humiris tools available to Claude Code in your current project or globally.

bash

# Add Humiris as an MCP server (project scope)
claude mcp add humiris --url https://humiris.com/mcp

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

You will be prompted to provide your Humiris 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
# humiris    https://humiris.com/mcp      connected

Available tools and resources

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

humiris_create_agentCreate a new agent with specified identity primitives

humiris_list_agentsList all agents in the workspace

humiris_send_emailSend an email from an agent

humiris_read_inboxRead an agent email inbox

humiris_send_smsSend an SMS from an agent phone number

humiris_read_smsRead received SMS messages

humiris_wallet_sendSend a crypto transaction

humiris_wallet_balanceCheck wallet balances

humiris_computer_execExecute a command on the agent VPS

humiris_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 Humiris. 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 humiris_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 humiris_send_email with the agent slug, recipient, and
a composed email body.

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

Claude will call humiris_read_inbox and summarize the results.

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

Claude will call humiris_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 humiris \
  --url https://humiris.com/mcp \
  --env HUMIRIS_API_KEY=hum_sk_live_...

# Remove the MCP server
claude mcp remove humiris

Next steps

Install the Humiris 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.