Connect your AI receptionist to Claude and ChatGPT

Every client connects to this URL over Streamable HTTP.

https://api.iris.dotfun.co/api/v1/mcp

Add Iris to Cursor and VS Code

These steps connect Cursor and VS Code with an API key in a header.

Cursor

1. Set IRIS_API_KEY in your environment.
2. Press Add to Cursor.
3. Open ~/.cursor/mcp.json and add the header to the iris entry:

{
  "mcpServers": {
    "iris": {
      "url": "https://api.iris.dotfun.co/api/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:IRIS_API_KEY}" }
    }
  }
}

VS Code

1. Press Install in VS Code.
2. From the Command Palette, run MCP: Open User Configuration.
3. Add the header to the iris server:

{
  "servers": {
    "iris": {
      "type": "http",
      "url": "https://api.iris.dotfun.co/api/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:iris-api-key}" }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "iris-api-key",
      "description": "Iris API key",
      "password": true
    }
  ]
}

VS Code asks for the key the first time it starts the server, and stores it for you.

Add Iris to Claude Code

Add the server:

claude mcp add --transport http iris https://api.iris.dotfun.co/api/v1/mcp

Then run /mcp in Claude Code, choose iris and sign in with Iris.

The Iris skill teaches Claude the Iris API and a daily routine. To get the skill, install the plugin from the Iris agent kit. The plugin connects with the API key in IRIS_API_KEY.

/plugin marketplace add Dot-Fun/iris-agent-kit
/plugin install iris@iris

Add Iris to Codex

Add the server and sign in with Iris. The Codex CLI, the desktop app and the IDE extension share this setting.

codex mcp add iris --url https://api.iris.dotfun.co/api/v1/mcp
codex mcp login iris

To use an API key instead, add the server to~/.codex/config.toml. Codex reads the key fromIRIS_API_KEY.

[mcp_servers.iris]
url = "https://api.iris.dotfun.co/api/v1/mcp"
bearer_token_env_var = "IRIS_API_KEY"

To get the Iris skill:

1. Run codex plugin marketplace add Dot-Fun/iris-agent-kit.
2. Open /plugins in Codex and install iris.

Add Iris as a Claude connector

1. In Claude or Claude Desktop, open Customize > Connectors.
2. Add a custom connector and name it Iris.
3. Paste the server URL and save.
4. Press Connect.
5. Sign in with Iris and approve access.

Add Iris as a ChatGPT connector

1. In Settings > Security and login, turn on Developer mode.
2. Open chatgpt.com/plugins and press the plus button.
3. Paste the server URL.
4. Sign in with Iris and approve access.

Add Iris to other MCP clients

Most other clients read a JSON file in this shape. They send an API key. Keep the key out of any file you share.

{
  "mcpServers": {
    "iris": {
      "type": "http",
      "url": "https://api.iris.dotfun.co/api/v1/mcp",
      "headers": { "Authorization": "Bearer iris_sk_..." }
    }
  }
}

Chat apps sign in with Iris. Claude, Claude Desktop and ChatGPT open an Iris sign-in page (OAuth). You approve access, and the app never sees your password.

Coding agents can use an API key. Claude Code and Codex can sign in with Iris or send an API key. Other clients send an API key. To create a key:

1. In the Iris dashboard, open Organization > API keys.
2. Create a key and choose its scopes. Iris shows the key once.
3. Send the key as Authorization: Bearer iris_sk_....

Never paste the key into a chat.

The server has 71 tools. Each one acts on one Iris organization.

The full reference is theOpenAPI documentin the Iris agent kit. AI tools can read the same reference fromllms.txt.

• Which leads called yesterday and did not book?
• Show tomorrow's appointments and flag any without a phone number.
• Summarize this week's calls. What did callers ask about most?
• Find contacts tagged "estimate sent" who have not replied in seven days, and draft a follow-up text for me to approve.
• Which sequence booked the most appointments last month?
• Move Maria Lopez's appointment on Friday to the next open time on Monday.

Write tools send real SMS to your customers, book and cancel real appointments, and change your contacts. Keep your client set to ask before it runs a tool. Read each write before you approve it.

For read-only access, create an API key with only read scopes:contacts:read, appointments:read,conversations:read, sequences:read,audiences:read, calls:read andforms:read. With that key, Iris refuses every write.

• Iris AI receptionist, which answers your calls, texts and chats
• Iris AI CRM, where every lead and conversation is stored
• Iris agent kit, with the skill, the plugins and the OpenAPI document
• Support
• Email connect@dotfun.co
• Privacy Policy
• Terms of Service