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

Setup Instructions

For Claude Desktop/Web:

Go to your Claude settings
Navigate to "Integrations" or "Connections"
Add a new MCP server with these details:
- Name: Telinfy
- Server URL: https://mcp.telinfy.com/sse
Save the configuration

For Claude Code (Command Line):

claude mcp add -s user -t http telinfy https://mcp.telinfy.com/sse

For Windsurf, Cursor, or other MCP clients:

Add this configuration to your MCP settings file:

{ "mcpServers": { "telinfy": { "serverUrl": "https://mcp.telinfy.com/sse" } } }

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

Telinfy Dashboard: https://telinfy.com
API Documentation: Contact Telinfy support for detailed API docs
MCP Protocol: https://modelcontextprotocol.io
Support: Contact your Telinfy account manager

Troubleshooting

Authentication Issues

If you encounter login problems:

Verify your username and password are correct
Check if your account has API access enabled
Contact Telinfy support to ensure your account has MCP access

Connection Issues

If the MCP server doesn't connect:

Verify the server URL is exactly: https://mcp.telinfy.com/sse
Check your internet connection
Try reconnecting the MCP server in your AI client settings

Message Delivery Issues

If messages aren't being sent:

Ensure you have sufficient credits in your Telinfy account
Verify DLT template IDs are correctly registered
Check that sender names are approved in your Telinfy account
Confirm phone numbers are in the correct format

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.

Getting Started Checklist

Connect Telinfy MCP server to your AI assistant
Authenticate with your Telinfy credentials
Verify you have active sender names and DLT templates
Check your account balance and credits
Test with a single SMS before bulk campaigns
Create organized phonebook groups
Set up scheduled campaigns for optimal timing
Monitor reports regularly

For detailed API specifications and parameter references, refer to the Telinfy API documentation or contact your account manager.

Telinfy MCP server