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

1. `send_sms` - Send SMS messages with DLT compliance

2. `schedule_sms` - Schedule SMS campaigns for future delivery

3. `scheduleDynamicCampaign` - Schedule dynamic SMS campaigns using Excel files and template variables

4. `get_sms_schedule` - View all scheduled SMS campaigns

5. `fetch_sms_campaign_report` - Get detailed reports for SMS campaigns

WhatsApp Operations

6. `send_whatsapp_campaign` - Send WhatsApp messages using pre-created templates

7. `whatsapp_campaign` - List all WhatsApp campaigns

8. `fetch_whatsapp_smart_report` - Get WhatsApp campaign reports with date filtering

RCS Operations

9. `fetch_rcs_report` - Retrieve RCS message reports with date filtering

Contact Management

10. `create_phonebook` - Create new phonebook groups with contacts

11. `get_phonebook_groups` - List all phonebook groups

12. `get_group_contacts` - View contacts within a specific group

13. `edit_contact` - Update contact information

14. `toggle_contact_status` - Enable/disable contacts in a group

15. `delete_contact_group` - Remove phonebook groups

Message Reporting

16. `getMessageReport` - Fetch message delivery reports and status for sent messages

Authentication

17. `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:

1. Go to your Claude settings

2. Navigate to "Integrations" or "Connections"

3. Add a new MCP server with these details:

4. 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.

Contact Management

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:

1. Verify your username and password are correct

2. Check if your account has API access enabled

3. Contact Telinfy support to ensure your account has MCP access

Connection Issues

If the MCP server doesn't connect:

1. Verify the server URL is exactly: `https://mcp.telinfy.com/sse`

2. Check your internet connection

3. Try reconnecting the MCP server in your AI client settings

Message Delivery Issues

If messages aren't being sent:

1. Ensure you have sufficient credits in your Telinfy account

2. Verify DLT template IDs are correctly registered

3. Check that sender names are approved in your Telinfy account

4. Confirm phone numbers are in the correct format

Best Practices

1. Always login first - Authenticate at the start of each session

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

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

4. Check campaign reports - Monitor delivery status regularly

5. Manage contacts efficiently - Keep phonebook groups organized

6. Test before bulk sending - Send test messages before large campaigns

Example Workflow

Here's a complete workflow for sending a campaign:

1. Authenticate

Log me into Telinfy with username "myuser" and password "mypass"

2. Create Contact Group

Create a phonebook group "Spring Sale 2024" with my customer list

3. 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"

4. 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.*