🔗 Telinfy MCP Connector

Connect Claude to the Telinfy messaging platform — send SMS and WhatsApp campaigns, manage phonebooks, and pull delivery reports through natural language.

What this connector does

The Telinfy connector is a remote Model Context Protocol (MCP) server operated by Telinfy. Once you connect it to Claude, you can ask Claude in plain language to:

Claude only ever acts on your Telinfy account, using access you grant through Telinfy's own sign-in — and every send uses the sender IDs and message templates already registered and approved on your account.

Telinfy is GreenAds Global's messaging platform. New to the idea? See the AI messaging campaigns overview and the WhatsApp MCP server announcement for the product story and pricing — this page is the technical reference for the connector itself.

Connect to Claude or Cursor

Claude on the web / desktop (claude.ai)

  1. Open Settings → Connectors in Claude.
  2. Choose Add custom connector and enter the server URL: https://mcp.telinfy.com
  3. Click Connect. A Telinfy sign-in window opens — log in with your Telinfy username and password and complete the reCAPTCHA.
  4. That's it. Telinfy tools are now available in your conversations. Try: "Show me my phonebook groups."

Claude Code (CLI)

claude mcp add --transport http telinfy https://mcp.telinfy.com

Claude Code will walk you through the same Telinfy sign-in in your browser the first time a tool is used.

Cursor

Add to Cursor (opens Cursor and adds the server), or add it to ~/.cursor/mcp.json yourself:

{
  "mcpServers": {
    "telinfy": { "url": "https://mcp.telinfy.com" }
  }
}

Cursor shows a Needs login button next to the server; click it to sign in with your Telinfy username and password. The same tools, consent rules and sign-in apply as in Claude.

How sign-in works (OAuth 2.0)

The connector uses the standard OAuth 2.0 authorization-code flow with PKCE:

  1. When you connect, Claude sends you to the Telinfy sign-in page hosted at https://mcp.telinfy.com/authorize.
  2. You sign in with your Telinfy credentials. Your password is sent only to Telinfy's login service — it is never stored by this connector and never shared with Claude or Anthropic.
  3. On success, Claude receives a short-lived access token for your account. The token is valid for up to 8 hours — never longer than your Telinfy sign-in session itself — after which Claude asks you to sign in again.

To disconnect at any time, remove the connector in Settings → Connectors. Access tokens expire automatically after 8 hours and can be revoked immediately via the connector's /revoke endpoint.

Prerequisites

Recipient consent — enforced. Campaigns may only be sent to recipients who have opted in to receive messages from you, in line with Telinfy's terms of service and applicable regulations (including TRAI/DLT rules for India). The connector enforces this: send_sms, schedule_sms and send_whatsapp_campaign verify every recipient against your Telinfy phonebook and refuse any number that is not a saved, active contact. Manage your consented audience with the phonebook tools — deactivating a contact records their opt-out and immediately excludes them from new sends and schedules. A campaign that was already scheduled before the opt-out is executed by the platform as queued.

Tool reference

These are the tools Claude can call on your behalf. read-only tools only fetch data; write tools send messages or change your account data, and Claude asks for your confirmation before using them.

SMS

Tool What it does Key inputs
send_sms write Send an SMS campaign immediately. Recipients must be saved, active phonebook contacts. campName, RType (0 promotional / 1 transactional), sn, msg, mnos, template_id
schedule_sms write Schedule an SMS campaign for a future time. Recipients must be saved, active phonebook contacts. Same as send_sms plus execTime (YYYY-MM-DD HH:mm:ss)
fetch_sms_campaign_report read-only Delivery report for one campaign. cid (campaign ID)
get_sms_schedule read-only List scheduled SMS campaigns. —
getMessageReport read-only Delivery status of sent messages. —

Dynamic Excel-based campaigns are currently available only in the Telinfy web portal; they will return to the connector once recipient consent checks for spreadsheet campaigns are in place.

WhatsApp

Tool What it does Key inputs
send_whatsapp_campaign write Send a WhatsApp campaign from an approved template. Recipients must be saved, active phonebook contacts. campaign_name, numbers, template_name, optional components, number_type
whatsapp_campaign read-only List your WhatsApp campaigns. —
fetch_whatsapp_smart_report read-only WhatsApp smart delivery report for a date range. frmDate, toDate

RCS

Tool What it does Key inputs
fetch_rcs_report read-only RCS delivery report for a date range. frmDate, toDate

Phonebook

Tool What it does Key inputs
create_phonebook write Create a contact group with contacts. groupName, contacts (first name, last name, phone)
get_phonebook_groups read-only List your contact groups (with group IDs). —
get_group_contacts read-only List the contacts in a group. groupID
edit_contact write Update a contact's name or phone number. contactID, name, phone
toggle_contact_status write Activate or deactivate (opt out) a contact. groupID, phoneNumber, status (1 active / 0 inactive)
delete_contact_group write Permanently delete a group and all its contacts. groupID

Troubleshooting

Symptom Cause & fix
"Unauthorized. Please reconnect your Telinfy account." Your access token has expired (sessions last up to 8 hours, or until your Telinfy sign-in session ends) or was revoked. Reconnect the connector in Settings → Connectors (or re-authenticate when Claude Code prompts you).
Sign-in fails with correct credentials Complete the reCAPTCHA before submitting. If it keeps failing, verify you can sign in at the Telinfy portal with the same credentials — your account may be locked or inactive.
"Invalid redirect URI" during sign-in For security, sign-in only works when it's started from Claude (claude.ai / claude.com) or Cursor. Start the connection from your assistant's connector settings rather than opening the sign-in page directly.
"Cannot send: these numbers are not saved, active contacts…" Sends only reach your opted-in phonebook contacts. Add the numbers to a phonebook group first (ask Claude to use create_phonebook), or reactivate a deactivated contact with toggle_contact_status, then retry.
SMS send fails or is rejected The sender ID (sn) and template_id must be DLT-registered and approved, and the message text must match the registered template. Check them in your Telinfy portal.
Scheduled campaign didn't run Verify the time was given as YYYY-MM-DD HH:mm:ss in IST and is in the future (the connector rejects past times). Use get_sms_schedule to confirm the campaign was registered.
"Rate limit exceeded" (HTTP 429) The server applies per-IP rate limits (e.g. 120 requests/minute on tool calls). Wait a minute and try again.
Not sure which URL to enter Use https://mcp.telinfy.com as the connector URL. Older guides may show https://mcp.telinfy.com/sse — if that doesn't connect, use the plain URL above.
Connector shows no tools / server unreachable Check https://mcp.telinfy.com/health — it returns OK when the connector and the Telinfy platform are up. If it doesn't, wait a few minutes or contact support.

Data & privacy

For developers

MCP endpoint (Streamable HTTP): https://mcp.telinfy.com/mcp · OAuth discovery: /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource · Health: https://mcp.telinfy.com/health

Support

Questions, onboarding help, or something not working? Email support@telinfy.com — include the approximate time and the error message shown in Claude, and we'll take it from there.