# Chatra MCP by usefulapi

> Chatra MCP by usefulapi is an MCP server. Read and update Chatra visitors; send, edit and delete chat and pushed messages. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/chatra/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/chatra
- **MCP Registry name:** io.usefulapi/chatra
- **Listing updated:** 2026-11-13

## About

Read and update Chatra visitors; send, edit and delete chat and pushed messages.

## Install

### Claude Code (Terminal)

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

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

```sh
https://chatra.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "chatra": {
      "url": "https://chatra.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "chatra": {
      "serverUrl": "https://chatra.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `chatra_get_visitor`: A chat visitor by id: name and contact details (basicInfo, integrationData and the merged `info`), custom form answers, location, browser, the link to the chat in the Chatra dashboard, the agent group, and the pages viewed in the latest visit. The id is the `clientId` your website passed to the widget or the visitor id from a Chatra webhook; Chatra has no endpoint to list or search visitors. GET /
- `chatra_update_visitor`: WRITE: edit a visitor's basic info (name, email, phone, notes) exactly as if an agent edited it in the Chatra dashboard. Only the fields you pass change; `null` removes a value. Returns the updated visitor. PUT /clients/{id}.
- `chatra_get_message`: One chat message by id (a visitor's or an agent's): type (agent or client), text, visitor id, agent id, timestamp (ms) and receivedFrom. Chatra has no endpoint to list a conversation, so the id must come from a send call or a webhook. GET /messages/{id}.
- `chatra_send_message`: WRITE: send a chat message to a visitor as a Chatra agent. The visitor sees it immediately in their chat window as if the agent typed it, so only call it with text the user asked you to send. It cannot be unsent except by deleting it. Say which agent writes: agent_id, or agent_email + agent_name + received_from (a dummy agent is created in Chatra when the email is unknown). For automated notices (
- `chatra_edit_message`: WRITE: replace the text of an agent message that was sent earlier. Only agents' messages can be edited, not visitors'. The visitor sees the edited text. Returns the updated message. PUT /messages/{id}.
- `chatra_delete_message`: WRITE, IRREVERSIBLE: delete an agent message from the conversation. Only agents' messages can be deleted, not visitors'. Returns the deleted message. DELETE /messages/{id}.
- `chatra_get_pushed_message`: One pushed (automated) message sent earlier by id: text, visitor id, agent id, timestamp (ms), isPushed. GET /pushedMessages/{id}.
- `chatra_push_message`: WRITE: send an automated message (order status, product update, announcement) to a visitor whose account is bound to Chatra through a clientId. It is delivered into the visitor's chat on behalf of a random agent, a given agent (agent_id) or a random agent of a group (group_id). It reaches a real customer and cannot be unsent except by deleting it, so only call it with text the user asked you to se
- `chatra_edit_pushed_message`: WRITE: replace the text of a pushed message sent earlier; the visitor sees the edited text. Returns the updated message. PUT /pushedMessages/{id}.
- `chatra_delete_pushed_message`: WRITE, IRREVERSIBLE: delete a pushed message sent earlier. Returns the deleted message. DELETE /pushedMessages/{id}.

## FAQ

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

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

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