MCP Server Documentation

Configuration File Location

Configuration

{
  "mcpServers": {
    "unisms": {
      "url": "https://unismsapi.com/mcp/sse",
      "headers": {
        "Authorization": "Basic YOUR_BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

Steps

1. Generate your Base64 credentials: echo -n 'YOUR_SECRET_KEY:' | base64
2. Open the Claude Desktop configuration file
3. Add the UniSMS server configuration above
4. Restart Claude Desktop
5. Start a new conversation and ask Claude to send an SMS

Option 1: CLI Command (Recommended)

claude mcp add --transport http --header "Authorization: Basic YOUR_BASE64_CREDENTIALS" unisms https://unismsapi.com/mcp/sse

Option 2: Edit .mcp.json

Create or edit .mcp.json in your project root:

{
  "mcpServers": {
    "unisms": {
      "type": "http",
      "url": "https://unismsapi.com/mcp/sse",
      "headers": {
        "Authorization": "Basic ${UNISMS_CREDENTIALS}"
      }
    }
  }
}

Steps

1. Run the claude mcp add command above
2. Verify the connection: claude mcp list
3. Start a conversation and ask Claude to send an SMS

Configuration File Locations

Configuration

{
  "mcpServers": {
    "unisms": {
      "url": "https://unismsapi.com/mcp/sse",
      "headers": {
        "Authorization": "Basic YOUR_BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

Steps

1. Create the .cursor directory in your project root (if it doesn't exist)
2. Create or edit .cursor/mcp.json with the configuration above
3. Restart Cursor or reload the window (Cmd+Shift+P → "Reload Window")
4. Verify the server shows a green dot in Settings → Tools & MCP
5. Switch to Agent mode and ask Cursor to send an SMS

Configuration File Locations

Configuration

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "unisms": {
      "type": "remote",
      "url": "https://unismsapi.com/mcp/sse",
      "headers": {
        "Authorization": "Basic YOUR_BASE64_ENCODED_CREDENTIALS"
      },
      "enabled": true
    }
  }
}

Steps

1. Create or edit opencode.json in your project root
2. Add the UniSMS server configuration above
3. Verify the connection: opencode mcp list
4. Ask OpenCode to send an SMS

Prerequisites

• N8N instance (self-hosted or cloud, v1.30+)
• AI Agent node (built-in)
• MCP Client Tool node (built-in, part of langchain nodes)

Step 1: Create a Workflow

Create a new workflow and add the following nodes:

1. Trigger — e.g., Webhook, Schedule, or Manual Trigger
2. AI Agent — The main agent node that processes requests
3. MCP Client Tool — Connect to the AI Agent's Tools input

Step 2: Configure the MCP Client Tool Node

In the MCP Client Tool node settings, configure the following:

Step 3: Configure the AI Agent Node

Connect the MCP Client Tool node to the AI Agent's Tools input. Set the agent's system prompt to describe what it can do:

You are an SMS assistant. You can send SMS messages, check message status, and check account credits using the UniSMS tools available to you.

When sending an SMS, always confirm the recipient number and message content with the user before sending.

Example Workflow

Webhook Trigger
    ↓
AI Agent (with MCP Client Tool)
    ↓
Respond to Webhook

Testing

Send a POST request to your webhook URL with a JSON body like:

{
  "message": "Send an SMS to +639123456789 saying 'Hello from N8N!'"
}

The AI Agent will process the request, call the send_sms tool via MCP, and return the result.

Input Schema

Example Response

{
  "content": [
    {
      "type": "text",
      "text": "SMS sent successfully. Message ID: msg_84e8b93b-6315-46af-a686, status: sent"
    }
  ]
}

Error Response

{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Failed to send SMS because it failed validation: [errors]"
    }
  ]
}

Input Schema

Example Response

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"reference_id\": \"msg_84e8b93b-6315-46af-a686\",\n  \"status\": \"sent\",\n  \"recipient\": \"+639123456789\",\n  \"content\": \"Hello from UniSMS!\",\n  \"metadata\": {},\n  \"fail_reason\": null,\n  \"sender_id\": \"UniSMS\",\n  \"created\": \"2026-03-16T14:32:44Z\"\n}"
    }
  ]
}

Message Statuses

Input Schema

No parameters required.

Example Response

{
  "content": [
    {
      "type": "text",
      "text": "Remaining SMS credits: 100"
    }
  ]
}