# AirysChat MCP Server

This MCP server connects Claude Code to AirysChat. An agent can work with conversations, CRM, AI agents, and WhatsApp campaigns through it.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: AirysChat
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AirysChat/mcp
- Updated: 2026-11-02
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/airyschat-mcp-server

## What it does

AirysChat MCP Server gives an agent access to AirysChat operations, including contacts and CRM, AI agent management, and WhatsApp templates and campaigns. It also exposes analytics reports, account administration, and Help Center tools.

Connect through the hosted HTTP endpoint or run the `@airyschat/mcp` package locally with `npx`. Local setup uses `AIRYSCHAT_BASE_URL`, `AIRYSCHAT_API_KEY`, `AIRYSCHAT_ACCOUNT_ID`, `AIRYSCHAT_TOOLSETS`, and `AIRYSCHAT_FEATURES`. The API key is one of the required local configuration values.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.airys.chat/mcp`
- Environment variables: `AIRYSCHAT_BASE_URL`, `AIRYSCHAT_API_KEY`, `AIRYSCHAT_ACCOUNT_ID`, `AIRYSCHAT_TOOLSETS`, `AIRYSCHAT_FEATURES`, `AIRYSCHAT_READ_ONLY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.airys.chat/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env AIRYSCHAT_BASE_URL=<AIRYSCHAT_BASE_URL> --env AIRYSCHAT_API_KEY=<AIRYSCHAT_API_KEY> --env AIRYSCHAT_ACCOUNT_ID=<AIRYSCHAT_ACCOUNT_ID> --env AIRYSCHAT_TOOLSETS=<AIRYSCHAT_TOOLSETS> --env AIRYSCHAT_FEATURES=<AIRYSCHAT_FEATURES> --transport stdio airyschat-mcp-server -- npx -y @airyschat/mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add airyschat-mcp-server --url https://mcp.airys.chat/mcp
```

2. **Platform CLI**
```bash
codex mcp add airyschat-mcp-server --env AIRYSCHAT_BASE_URL=<AIRYSCHAT_BASE_URL> --env AIRYSCHAT_API_KEY=<AIRYSCHAT_API_KEY> --env AIRYSCHAT_ACCOUNT_ID=<AIRYSCHAT_ACCOUNT_ID> --env AIRYSCHAT_TOOLSETS=<AIRYSCHAT_TOOLSETS> --env AIRYSCHAT_FEATURES=<AIRYSCHAT_FEATURES> -- npx -y @airyschat/mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "airyschat-mcp-server": {
            "url": "https://mcp.airys.chat/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "airyschat-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@airyschat/mcp"
            ],
            "env": {
                "AIRYSCHAT_BASE_URL": "<AIRYSCHAT_BASE_URL>",
                "AIRYSCHAT_API_KEY": "<AIRYSCHAT_API_KEY>",
                "AIRYSCHAT_ACCOUNT_ID": "<AIRYSCHAT_ACCOUNT_ID>",
                "AIRYSCHAT_TOOLSETS": "<AIRYSCHAT_TOOLSETS>",
                "AIRYSCHAT_FEATURES": "<AIRYSCHAT_FEATURES>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "airyschat-mcp-server": {
            "type": "http",
            "url": "https://mcp.airys.chat/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "airyschat-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@airyschat/mcp"
            ],
            "env": {
                "AIRYSCHAT_BASE_URL": "<AIRYSCHAT_BASE_URL>",
                "AIRYSCHAT_API_KEY": "<AIRYSCHAT_API_KEY>",
                "AIRYSCHAT_ACCOUNT_ID": "<AIRYSCHAT_ACCOUNT_ID>",
                "AIRYSCHAT_TOOLSETS": "<AIRYSCHAT_TOOLSETS>",
                "AIRYSCHAT_FEATURES": "<AIRYSCHAT_FEATURES>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http airyschat-mcp-server https://mcp.airys.chat/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e AIRYSCHAT_BASE_URL=<AIRYSCHAT_BASE_URL> -e AIRYSCHAT_API_KEY=<AIRYSCHAT_API_KEY> -e AIRYSCHAT_ACCOUNT_ID=<AIRYSCHAT_ACCOUNT_ID> -e AIRYSCHAT_TOOLSETS=<AIRYSCHAT_TOOLSETS> -e AIRYSCHAT_FEATURES=<AIRYSCHAT_FEATURES> airyschat-mcp-server npx -y @airyschat/mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- find AirysChat conversations and contacts
- manage CRM records through an AI agent
- work with WhatsApp templates and campaigns
- retrieve reports and use the Help Center

## Example prompts
- Find recent conversations and contacts in AirysChat.
- Show the current CRM and AI agent setup in AirysChat.
- Check the WhatsApp campaigns and templates in AirysChat.

## Similar
- [ManyContacts.com MCP for WhatsApp Business](https://affpapa.org/en/nevibecode/mcp/manycontactscom-mcp-for-whatsapp-business.md) — MCP server · 251 installs
- [InboundPilot — AI Lead Qualifier & Support for Social Media](https://affpapa.org/en/nevibecode/mcp/inboundpilot-ai-lead-qualifier-support-for-social-media.md) — MCP server · 643 installs
- [DarkFunnels](https://affpapa.org/en/nevibecode/mcp/darkfunnels.md) — MCP server
- [FavCRM](https://affpapa.org/en/nevibecode/mcp/favcrm.md) — MCP server
- [whatsapp-marketing](https://affpapa.org/en/nevibecode/skills/whatsapp-marketing.md) — skill · 2000 installs
- [ToFlow](https://affpapa.org/en/nevibecode/mcp/toflow.md) — MCP server · ★ 6 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
