# IRIS CRM MCP by usefulapi

> IRIS CRM MCP by usefulapi is a freemium MCP server for sales and crm. Read-only MCP connector for IRIS CRM leads, notes, merchants and users in AI clients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode, CLI
- **Website:** https://usefulapi.io/iris-crm/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/iris-crm
- **MCP Registry name:** io.usefulapi/iris-crm
- **Categories:** sales and CRM
- **Listing updated:** 2026-11-18

## About

The README says it lets Claude, Cursor and other MCP clients read data from an IRIS CRM account without installing anything locally. The server is hosted by usefulapi, and each user signs in with their own IRIS CRM subdomain and API token, so the assistant only sees what that account can access.

Six read-only tools cover leads with their field values, lead notes, lead field definitions, merchants (processing accounts) and CRM users. Filters include owner, source, status, campaign, processor and date ranges, so a sales rep can ask questions like which leads arrived this week or which merchants were created recently.

The product is aimed at payment sales teams that already work in IRIS CRM and want to query their pipeline from a chat assistant. usefulapi describes it as an independent service, not affiliated with IRIS CRM.

## Features

- **Hosted remote endpoint:** Connects over Streamable HTTP, so there is no local install; clients add only the server URL.
- **OAuth sign-in:** Users log in with their IRIS CRM subdomain and API token instead of putting keys in config files.
- **Lead and note reads:** Lists leads with filters and reads lead notes, optionally from one note tab.
- **Merchant and user lookup:** Filters merchants by processor, status and dates, and lists CRM users with their active flag.
- **Read-only tools:** All six data tools are marked read-only, so the assistant cannot change CRM records through them.
- **Usage metering:** A status tool reports calls used against the plan's monthly limit.

## Good for

- Check which leads were added this week and who owns them
- Review the notes on a lead before contacting it
- List merchants created in the last 30 days
- See which CRM users are currently active
- Map lead field ids before looking up specific lead values

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http iris-crm https://iris-crm.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://iris-crm.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "iris-crm": {
      "url": "https://iris-crm.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "iris-crm": {
      "type": "http",
      "url": "https://iris-crm.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "iris-crm": {
      "serverUrl": "https://iris-crm.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "iris-crm": {
      "type": "http",
      "url": "https://iris-crm.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `iriscrm_list_leads`: List CRM leads with filters by group, merchant id, campaign, source, status, status category, owner user and date range.
- `iriscrm_get_lead`: Get one lead with its field values.
- `iriscrm_list_lead_notes`: List the notes on one lead, optionally from one note tab.
- `iriscrm_list_lead_fields`: List lead field definitions and their ids.
- `iriscrm_list_merchants`: List merchants with filters by group, processor, merchant id, name, status, active flag and date range.
- `iriscrm_list_users`: List CRM users with their class and active flag.

## FAQ

### Can the AI change my IRIS CRM data?

All six IRIS CRM data tools are marked read-only. The README and listing do not describe any write tools.

### Do I need to put an API key in my client config?

No. The listing says to add only the URL and not an Authorization header or API key; the server signs you in with OAuth and asks for your subdomain and API token on the login page.

### Is this an official IRIS CRM product?

No. The listing states usefulapi is an independent service and is not affiliated with or endorsed by IRIS CRM.

### What does it cost?

The Free plan includes 50 tool calls per month. Pro is $9/mo or $90/yr with 10,000 calls per month, and Pro+ is $39/mo or $390/yr with 100,000 calls per month.

### Is IRIS CRM MCP by usefulapi free?

IRIS CRM MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add IRIS CRM MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http iris-crm https://iris-crm.usefulapi.io/mcp

### What are the best alternatives to IRIS CRM MCP by usefulapi?

The closest alternatives to IRIS CRM MCP by usefulapi are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.
- [Fuse](https://ai-powered.com/mcp/fuse-2): Fuse is a freemium MCP server for sales and crm.
- [Gender-API.com](https://ai-powered.com/mcp/gender-api-com): Gender-API.com is a freemium MCP server for analytics and data.
- [Dialvett: Bulk Phone Number Validator & Carrier Lookup](https://ai-powered.com/mcp/dialvett-bulk-phone-number-validator-and-carrier-lookup): Dialvett: Bulk Phone Number Validator & Carrier Lookup is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/iris-crm-mcp-by-usefulapi
