The ShingleAI MCP server provides 7 tools for accessing and managing messages. These tools allow you to retrieve messages, search content, manage message status, and view conversation threads.
getMessage
Get detailed information about a specific message by its ID, including all message type-specific fields (email headers, SMS encoding, WhatsApp media, etc.).
Permission: messages:read
Parameters:
| Name | Type | Required | Description |
|---|
messageId | string (UUID) | Yes | ID of the message to retrieve |
listMessages
List messages in the organization with optional filtering.
Permission: messages:read
Parameters:
| Name | Type | Required | Default | Description |
|---|
limit | number | No | 10 | Maximum number of messages to return (1-100) |
offset | number | No | 0 | Offset for pagination |
sortOrder | string | No | ”desc” | Sort order by creation date (“asc” or “desc”) |
direction | string | No | - | Filter by message direction (“incoming” or “outgoing”) |
searchMessages
Search messages using semantic search to find messages containing specific content or related to specific topics. Uses AI-powered search to find relevant messages even if they don’t contain exact keywords.
Permission: messages:read
Parameters:
| Name | Type | Required | Default | Description |
|---|
query | string | Yes | - | Search query (e.g., “invoice”, “meeting tomorrow”) |
limit | number | No | 10 | Maximum number of messages to return (1-100) |
offset | number | No | 0 | Offset for pagination |
direction | string | No | - | Filter by message direction (“incoming” or “outgoing”) |
The search uses semantic matching, so queries like “customer complaint” will find relevant messages even if they don’t contain those exact words.
updateMessageStatus
Update the status of a message - mark as read/unread, archive/unarchive, or snooze/unsnooze.
Permission: messages:write
Parameters:
| Name | Type | Required | Description |
|---|
messageId | string (UUID) | Yes | ID of the message to update |
readAt | string | null | No | ISO datetime to mark as read, or null to mark as unread |
archivedAt | string | null | No | ISO datetime to archive, or null to unarchive |
snoozedUntil | string | null | No | ISO datetime to snooze until, or null to unsnooze |
This tool only allows updating status fields for security reasons. To modify message content, use the appropriate channel-specific tools.
Get all messages sent to or received from a specific contact. Useful for viewing the complete communication history with a contact.
Permission: messages:read
Parameters:
| Name | Type | Required | Default | Description |
|---|
contactId | string (UUID) | Yes | - | Contact ID to retrieve messages for |
limit | number | No | 20 | Maximum number of messages to return (1-100) |
offset | number | No | 0 | Offset for pagination |
sortOrder | string | No | ”desc” | Sort order by creation date (“asc” or “desc”) |
direction | string | No | - | Filter by direction (“incoming” = from contact, “outgoing” = to contact) |
getMessageThread
Get all messages that belong to the same conversation thread. Useful for viewing the complete conversation history.
Permission: messages:read
Parameters:
| Name | Type | Required | Default | Description |
|---|
threadId | string | Yes | - | Thread ID to retrieve messages for |
limit | number | No | 50 | Maximum number of messages to return (1-100) |
offset | number | No | 0 | Offset for pagination |
sortOrder | string | No | ”asc” | Sort order (“asc” = oldest first for conversation flow, “desc” = newest first) |
direction | string | No | - | Filter by message direction (“incoming” or “outgoing”) |
listMessageAttachments
List all file attachments associated with a specific message, including details like filename, size, content type, and URL.
Permission: messages:read
Parameters:
| Name | Type | Required | Default | Description |
|---|
messageId | string (UUID) | Yes | - | ID of the message |
limit | number | No | 20 | Maximum number of attachments to return |
offset | number | No | 0 | Offset for pagination |
sortOrder | string | No | ”asc” | Sort order by creation date (“asc” or “desc”) |
Next Steps
