Labsco
vineethnj logo

Telinfy MCP server

from vineethnj

Send SMS, WhatsApp, and RCS messages programmatically with DLT compliance. Manage contacts, schedule campaigns, and track delivery reports.

๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeQuick setup

Telinfy MCP Integration Guide

How to connect and use the Telinfy MCP server with AI assistants

The Telinfy MCP server provides programmatic access to Telinfy's SMS, WhatsApp, and RCS messaging capabilities, allowing AI assistants to send messages, manage contacts, schedule campaigns, and retrieve reports on your behalf.

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI applications to securely connect to MCP-compatible data sources and tools. Think of MCP like a USB-C port for AI applications - a standardized way to connect AI apps to different services.

Telinfy MCP Server

The Telinfy MCP server is a secure, authenticated service that provides access to your Telinfy messaging platform.

Base Server URL: https://mcp.telinfy.com/sse

Authentication Required

To use the Telinfy MCP server, you need:

  • Telinfy username

  • Telinfy password

  • API credentials (automatically retrieved after login)

Available Tools

The Telinfy MCP server offers comprehensive messaging and campaign management tools:

SMS Operations

  • send_sms - Send SMS messages with DLT compliance

  • schedule_sms - Schedule SMS campaigns for future delivery

  • scheduleDynamicCampaign - Schedule dynamic SMS campaigns using Excel files and template variables

  • get_sms_schedule - View all scheduled SMS campaigns

  • fetch_sms_campaign_report - Get detailed reports for SMS campaigns

WhatsApp Operations

  • send_whatsapp_campaign - Send WhatsApp messages using pre-created templates

  • whatsapp_campaign - List all WhatsApp campaigns

  • fetch_whatsapp_smart_report - Get WhatsApp campaign reports with date filtering

RCS Operations

  • fetch_rcs_report - Retrieve RCS message reports with date filtering

Contact Management

  • create_phonebook - Create new phonebook groups with contacts

  • get_phonebook_groups - List all phonebook groups

  • get_group_contacts - View contacts within a specific group

  • edit_contact - Update contact information

  • toggle_contact_status - Enable/disable contacts in a group

  • delete_contact_group - Remove phonebook groups

Message Reporting

  • getMessageReport - Fetch message delivery reports and status for sent messages

Authentication

  • login_to_telinfy - Authenticate and establish a session with the Telinfy platform

Wire Protocol

The Telinfy MCP server uses the SSE (Server-Sent Events) protocol:

SSE (Server-Sent Events) - /sse

  • URL: https://mcp.telinfy.com/sse

  • The official MCP specification version

  • Supported by Claude, Windsurf, Cursor, and other MCP clients

  • Recommended for all integrations

Using Telinfy MCP

Initial Setup

After connecting the MCP server, you'll need to authenticate with your Telinfy credentials:

Claude, please log me into Telinfy using my username and password.

The AI assistant will use the login_to_telinfy tool to establish a secure session.

Example Use Cases

Send an SMS Campaign

Send an SMS to +919876543210 with the message "Your OTP is 123456" 
using sender name "NOTIFY" and template ID "1234567890"

Schedule a Marketing Campaign

Schedule an SMS campaign named "Weekend Sale" to be sent tomorrow at 10 AM 
to these numbers: +919876543210, +919876543211 with the message 
"Flash Sale this weekend! 50% off. Visit now."

Create a Contact Group

Create a new phonebook group called "VIP Customers" with these contacts:
- John Doe, +919876543210
- Jane Smith, +919876543211

Send WhatsApp Messages

Send a WhatsApp campaign using my "order_confirmation" template 
to +919876543210 with customer name "John" and order number "ORD123"

Get Campaign Reports

Show me the SMS campaign report for campaign ID "12345"

Fetch Message Delivery Status

Get the delivery status for all messages sent today

Key Features

DLT Compliance

All SMS campaigns support DLT (Distributed Ledger Technology) compliance with template IDs and sender names, ensuring regulatory compliance in India.

Dynamic Campaigns

Schedule personalized SMS campaigns using Excel files with variable substitution, perfect for bulk personalized messaging.

Multi-Channel Messaging

  • SMS - Promotional and transactional routes

  • WhatsApp - Template-based business messaging

  • RCS - Rich Communication Services

Comprehensive Reporting

Track message delivery, campaign performance, and generate detailed reports with date filtering.

Organize contacts into groups, enable/disable contacts, and maintain clean phonebook lists.

Security & Authentication

  • All API calls are authenticated using your Telinfy credentials

  • Secure token-based authentication after initial login

  • Sessions are maintained for the duration of your conversation

  • No credentials are stored by the AI assistant

Support & Resources

Best Practices

  • Always login first - Authenticate at the start of each session

  • Use correct template IDs - Ensure DLT templates match your message content

  • Verify phone formats - Use 10-digit Indian numbers or international format with country code

  • Check campaign reports - Monitor delivery status regularly

  • Manage contacts efficiently - Keep phonebook groups organized

  • Test before bulk sending - Send test messages before large campaigns

Example Workflow

Here's a complete workflow for sending a campaign:

  • Authenticate
Log me into Telinfy with username "myuser" and password "mypass" 
  • Create Contact Group
Create a phonebook group "Spring Sale 2024" with my customer list 
  • Schedule Campaign
Schedule an SMS campaign "Spring Sale Announcement" to the "Spring Sale 2024" 
group for tomorrow at 9 AM with message "Exclusive Spring Sale! 40% off all items. 
Shop now at example.com" using sender "RETAIL" and template "1234567890" 
  • Monitor Results
Show me the delivery report for the Spring Sale campaign 

Advanced Features

Dynamic Variable Substitution

Use Excel files to send personalized messages at scale:

  • Upload Excel with columns: Mobile, Name, OrderID, Amount

  • Map variables: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount

  • Template: "Hi {{1}}, your order {{2}} of Rs.{{3}} is confirmed"

Multi-Route SMS

  • Route 0: Promotional messages

  • Route 1: Transactional messages (OTPs, alerts)

Unicode Support

Send messages in regional languages by enabling Unicode mode.