veryfront__check_channelAccess
Requires a user connection forslack.
Call type: Can change resources.
Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
project_reference | string | No | Project ID or slug. Requires a person’s credential; agent, run, and service-account callers are forbidden. |
channel_id | string | Yes | Channel ID from list_channels Format: uuid. |
slack_channel_id | string | Yes | Slack channel for the test message. Slack refusals return status failed with a failure code. A missing Slack connection returns validation-failed; a transient connection refresh failure returns external-service-error. Minimum length: 1. Maximum length: 255. |
text | string | No | Message text, 1-4000 characters; default ‘Veryfront Slack connection test’ Minimum length: 1. Maximum length: 4000. |
Example request
Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__check_channel",
"arguments": {
"channel_id": "00000000-0000-4000-8000-000000000000",
"slack_channel_id": "example"
}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel_id | string | Yes | The channel id returned by the tool. Format: uuid. |
slack_channel_id | string | Yes | The slack channel id returned by the tool. |
status | string | Yes | Lifecycle status for the returned record. Values: "delivered", "failed". |
message_id | string or null | Yes | The message id returned by the tool. |
failure_code | string or null | Yes | The failure code returned by the tool. |
retryable | boolean | Yes | The retryable returned by the tool. |
checked_at | string | Yes | The checked at returned by the tool. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug. Requires a person's credential; agent, run, and service-account callers are forbidden."
},
"channel_id": {
"type": "string",
"format": "uuid",
"description": "Channel ID from list_channels"
},
"slack_channel_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Slack channel for the test message. Slack refusals return status failed with a failure code. A missing Slack connection returns validation-failed; a transient connection refresh failure returns external-service-error."
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "Message text, 1-4000 characters; default 'Veryfront Slack connection test'"
}
},
"required": [
"channel_id",
"slack_channel_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Arguments for the check_channel tool."
}
{
"type": "object",
"properties": {
"channel_id": {
"type": "string",
"format": "uuid",
"description": "The channel id returned by the tool."
},
"slack_channel_id": {
"type": "string",
"description": "The slack channel id returned by the tool."
},
"status": {
"type": "string",
"enum": [
"delivered",
"failed"
],
"description": "Lifecycle status for the returned record."
},
"message_id": {
"type": [
"string",
"null"
],
"description": "The message id returned by the tool."
},
"failure_code": {
"anyOf": [
{
"type": "string",
"enum": [
"not_in_channel",
"channel_not_found",
"needs_reauth",
"rate_limited",
"provider_error"
],
"description": "The failure code returned by the tool."
},
{
"type": "null",
"description": "The failure code returned by the tool."
}
],
"description": "The failure code returned by the tool."
},
"retryable": {
"type": "boolean",
"description": "The retryable returned by the tool."
},
"checked_at": {
"type": "string",
"description": "The checked at returned by the tool."
}
},
"required": [
"channel_id",
"slack_channel_id",
"status",
"message_id",
"failure_code",
"retryable",
"checked_at"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Structured result returned by the check_channel tool."
}