Skip to main content

Model Context Protocol (MCP)

Early Access

Try our newest feature! Only available through reach out. Contact us to join the early access program and get priority support.

Unizo offers an MCP server that integrates communication platforms with any LLM provider supporting the MCP protocol. This enables your AI agent to send messages, manage channels, and automate communication workflows across Slack, Microsoft Teams, Discord, and other messaging platforms via a single MCP server.

Supported Tools & Use Cases​

The following tools are available in the Communication MCP Server:

Tool NameDescription
list_servicesGet list of available communication services
list_integrationsGet integrations for a specific communication service
list_organizationsBrowse and search organizations with pagination
get_organization_detailsGet detailed information about a specific organization
list_channelsBrowse and search channels for an organization
get_channel_detailsGet detailed information about a specific channel
create_messageSend messages to channels with rich formatting and attachments

Tool Reference

list_services​

Get list of available communication services

Parameters:
None

Returns:
List of available communication services

list_integrations​

Get integrations for a specific communication service

Parameters:

  • service (string, required): Name of the communication service

Returns:
List of integrations for the specified service

list_organizations​

Browse and search organizations with pagination

Parameters:

  • offset (integer, optional): Number of items to skip (default: 0)
  • limit (integer, optional): Maximum number of items to return (default: 20, max: 100)
  • sort (string, optional): Sort criteria (e.g., name, -createdDateTime)

Returns:
Paginated list of organizations with metadata

get_organization_details​

Get detailed information about a specific organization

Parameters:

  • organization_id (string, required): Unique identifier of the organization

Returns:
Detailed organization information

list_channels​

Browse and search channels for an organization

Parameters:

  • organization_id (string, required): Unique identifier of the organization
  • offset (integer, optional): Number of items to skip (default: 0)
  • limit (integer, optional): Maximum number of items to return (default: 20, max: 100)
  • sort (string, optional): Sort criteria (e.g., name, -createdDateTime)
  • parent_id (string, optional): Filter channels by their parent channel ID

Returns:
Paginated list of channels for the organization

get_channel_details​

Get detailed information about a specific channel

Parameters:

  • organization_id (string, required): Unique identifier of the organization
  • channel_id (string, required): Unique identifier of the channel

Returns:
Detailed channel information

create_message​

Send messages to channels with rich formatting and attachments

Parameters:

  • organization_id (string, required): Unique identifier of the organization
  • channel_id (string, required): Unique identifier of the destination channel
  • message_body (string, required): Content of the message to be sent
  • name (string, optional): Subject or title of the message
  • attachments (array, optional): List of attachment objects with the following structure:
    • id (string, required): Unique identifier for the attachment
    • contentType (string, optional): MIME type of the attachment
    • authorName (string, optional): Name of the person who created the attachment
    • title (string, optional): Title or name of the attachment
    • titleLink (string, optional): URL to access the attachment
    • text (string, optional): Preview or description of the attachment content
    • fields (array, optional): Additional metadata fields

Returns:
Created message information

Installation​

Prerequisites​

  • A Unizo API key
  • An active Communications integration (Slack, Google Chat, Microsoft Teams)
  • Node.js v20 or higher

MCP Configuration​

Here is an example configuration for setting up the Unizo Communication MCP Server:

{
  "mcpServers": {
    "unizo-comms": {
        "command": "npx",
      "args": [
        "mcp-remote",
        "http://api.unizo.ai/mcp/comms",
        "--allow-http",
        "--header",
        "apikey:${UNIZO_API_KEY}"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

Client Setup​

For detailed setup instructions with specific AI clients:

Environment Variables​

The following environment variables are required:

Error Handling​

All tools return errors in a consistent format:

{
  "error": {
    "code": "CHANNEL_NOT_FOUND",
    "message": "Channel 'team-updates' not found"
  }
}

Common error codes:

  • INTEGRATION_NOT_FOUND: Invalid communication platform integration ID
  • CHANNEL_NOT_FOUND: Channel does not exist or access is denied
  • USER_NOT_FOUND: User is not found or inaccessible
  • MESSAGE_FAILED: Message could not be delivered
  • RATE_LIMIT_EXCEEDED: Too many requests sent to the API
  • UNAUTHORIZED: Invalid credentials or insufficient permissions