Chatra MCP by usefulapi is an MCP server published by io.usefulapi, hosted at chatra.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 10 tools, including chatra_get_visitor, chatra_update_visitor, chatra_get_message, chatra_send_message, chatra_edit_message.
Read and update Chatra visitors; send, edit and delete chat and pushed messages.
4,265 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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 /clients/{id}.
| Parameter | Type | Description |
|---|---|---|
| client_id * | string | Chatra visitor id: the `clientId` your website passed to the chat widget (ChatraSetup.clientId) or the visitor id from a Chatra webhook (client.id). |
{
"name": "chatra_get_visitor",
"title": "Get visitor",
"description": "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 /clients/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra visitor id: the `clientId` your website passed to the chat widget (ChatraSetup.clientId) or the visitor id from a Chatra webhook (client.id)."
}
}
},
"annotations": {
"title": "Get visitor",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| name | any | Visitor name; null removes it. |
| any | Visitor email; null removes it. | |
| notes | any | Agent notes about the visitor; null removes them. |
| phone | any | Visitor phone number; null removes it. |
| client_id * | string | Chatra visitor id: the `clientId` your website passed to the chat widget (ChatraSetup.clientId) or the visitor id from a Chatra webhook (client.id). |
{
"name": "chatra_update_visitor",
"title": "Update visitor",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "null"
}
],
"description": "Visitor name; null removes it."
},
"email": {
"anyOf": [
{
"type": "string",
"maxLength": 320,
"minLength": 3
},
{
"type": "null"
}
],
"description": "Visitor email; null removes it."
},
"notes": {
"anyOf": [
{
"type": "string",
"maxLength": 5000,
"minLength": 1
},
{
"type": "null"
}
],
"description": "Agent notes about the visitor; null removes them."
},
"phone": {
"anyOf": [
{
"type": "string",
"maxLength": 50,
"minLength": 1
},
{
"type": "null"
}
],
"description": "Visitor phone number; null removes it."
},
"client_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra visitor id: the `clientId` your website passed to the chat widget (ChatraSetup.clientId) or the visitor id from a Chatra webhook (client.id)."
}
}
},
"annotations": {
"title": "Update visitor",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| message_id * | string | Chatra message id (from the reply of a send call or from a webhook). |
{
"name": "chatra_get_message",
"title": "Get message",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra message id (from the reply of a send call or from a webhook)."
}
}
},
"annotations": {
"title": "Get message",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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 (order status, announcements) use chatra_push_message instead. Returns the new message with its id. POST /messages/.
| Parameter | Type | Description |
|---|---|---|
| text * | string | Message text (plain text, 1-5000 characters). |
| agent_id | string | Chatra agent id (shown on the agent's page in Chatra). |
| client_id * | string | Chatra visitor id: the `clientId` your website passed to the chat widget (ChatraSetup.clientId) or the visitor id from a Chatra webhook (client.id). |
| agent_name | string | Agent display name (with agent_email). |
| agent_email | string | Agent email (instead of agent_id; needs agent_name and received_from). |
| received_from | string | Short name of the sending system, e.g. 'usefulapi-mcp'; marks the message in webhooks. |
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}.
| Parameter | Type | Description |
|---|---|---|
| text * | string | Message text (plain text, 1-5000 characters). |
| message_id * | string | Chatra message id (from the reply of a send call or from a webhook). |
{
"name": "chatra_edit_message",
"title": "Edit agent message",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id",
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 5000,
"minLength": 1,
"description": "Message text (plain text, 1-5000 characters)."
},
"message_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra message id (from the reply of a send call or from a webhook)."
}
}
},
"annotations": {
"title": "Edit agent message",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE, IRREVERSIBLE: delete an agent message from the conversation. Only agents' messages can be deleted, not visitors'. Returns the deleted message. DELETE /messages/{id}.
| Parameter | Type | Description |
|---|---|---|
| message_id * | string | Chatra message id (from the reply of a send call or from a webhook). |
{
"name": "chatra_delete_message",
"title": "Delete agent message",
"description": "WRITE, IRREVERSIBLE: delete an agent message from the conversation. Only agents' messages can be deleted, not visitors'. Returns the deleted message. DELETE /messages/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra message id (from the reply of a send call or from a webhook)."
}
}
},
"annotations": {
"title": "Delete agent message",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}One pushed (automated) message sent earlier by id: text, visitor id, agent id, timestamp (ms), isPushed. GET /pushedMessages/{id}.
| Parameter | Type | Description |
|---|---|---|
| message_id * | string | Chatra message id (from the reply of a send call or from a webhook). |
{
"name": "chatra_get_pushed_message",
"title": "Get pushed message",
"description": "One pushed (automated) message sent earlier by id: text, visitor id, agent id, timestamp (ms), isPushed. GET /pushedMessages/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra message id (from the reply of a send call or from a webhook)."
}
}
},
"annotations": {
"title": "Get pushed message",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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 send. Returns the new message with its id. POST /pushedMessages/.
| Parameter | Type | Description |
|---|---|---|
| text * | string | Message text (plain text, 1-5000 characters). |
| agent_id | string | Chatra agent id (shown on the agent's page in Chatra). |
| group_id | string | Chatra agent group id (on the group's page); a random agent of the group writes. |
| client_id * | string | Chatra visitor id: the `clientId` your website passed to the chat widget (ChatraSetup.clientId) or the visitor id from a Chatra webhook (client.id). |
{
"name": "chatra_push_message",
"title": "Push message to a visitor",
"description": "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 send. Returns the new message with its id. POST /pushedMessages/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id",
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 5000,
"minLength": 1,
"description": "Message text (plain text, 1-5000 characters)."
},
"agent_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra agent id (shown on the agent's page in Chatra)."
},
"group_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra agent group id (on the group's page); a random agent of the group writes."
},
"client_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra visitor id: the `clientId` your website passed to the chat widget (ChatraSetup.clientId) or the visitor id from a Chatra webhook (client.id)."
}
}
},
"annotations": {
"title": "Push message to a visitor",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: replace the text of a pushed message sent earlier; the visitor sees the edited text. Returns the updated message. PUT /pushedMessages/{id}.
| Parameter | Type | Description |
|---|---|---|
| text * | string | Message text (plain text, 1-5000 characters). |
| message_id * | string | Chatra message id (from the reply of a send call or from a webhook). |
{
"name": "chatra_edit_pushed_message",
"title": "Edit pushed message",
"description": "WRITE: replace the text of a pushed message sent earlier; the visitor sees the edited text. Returns the updated message. PUT /pushedMessages/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id",
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 5000,
"minLength": 1,
"description": "Message text (plain text, 1-5000 characters)."
},
"message_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra message id (from the reply of a send call or from a webhook)."
}
}
},
"annotations": {
"title": "Edit pushed message",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE, IRREVERSIBLE: delete a pushed message sent earlier. Returns the deleted message. DELETE /pushedMessages/{id}.
| Parameter | Type | Description |
|---|---|---|
| message_id * | string | Chatra message id (from the reply of a send call or from a webhook). |
{
"name": "chatra_delete_pushed_message",
"title": "Delete pushed message",
"description": "WRITE, IRREVERSIBLE: delete a pushed message sent earlier. Returns the deleted message. DELETE /pushedMessages/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra message id (from the reply of a send call or from a webhook)."
}
}
},
"annotations": {
"title": "Delete pushed message",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Chatra, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Show the contact details and viewed pages of Chatra visitor 5f3a9c."; "Send a Chatra message to visitor 5f3a9c as agent Liz: your refund has been issued."; "Push 'Your order has shipped, tracking number 9114 5847' to visitor 5f3a9c.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Chatra data. Free plan: 50 tool calls per month. Run chatra_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run chatra_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run chatra_upgrade without a plan: it returns both plans, each with a payment link for the user to open. chatra_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "chatra_send_message",
"title": "Send message as an agent",
"description": "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 (order status, announcements) use chatra_push_message instead. Returns the new message with its id. POST /messages/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id",
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 5000,
"minLength": 1,
"description": "Message text (plain text, 1-5000 characters)."
},
"agent_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra agent id (shown on the agent's page in Chatra)."
},
"client_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Chatra visitor id: the `clientId` your website passed to the chat widget (ChatraSetup.clientId) or the visitor id from a Chatra webhook (client.id)."
},
"agent_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Agent display name (with agent_email)."
},
"agent_email": {
"type": "string",
"maxLength": 320,
"minLength": 3,
"description": "Agent email (instead of agent_id; needs agent_name and received_from)."
},
"received_from": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Short name of the sending system, e.g. 'usefulapi-mcp'; marks the message in webhooks."
}
}
},
"annotations": {
"title": "Send message as an agent",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}