Reteno
Reteno is a customer engagement platform for managing contacts, behavioral events, messaging campaigns, and omnichannel communications.
Verdict
Common use cases
- Pull contact profiles during support escalations
- Audit message delivery for campaign retrospectives
- Check account balance before scheduling sends
- List custom fields when building segmentation logic
- Verify import job status after bulk uploads
Integration
- Vendor
- Reteno
- Category
- other
- Auth
- API_KEY
- Tools
- 14
- Composio slug
reteno
Tools
- Get Account Balance
Return monetary balance, credit limit, currency, and remaining prepaid email and SMS quotas for the connected Reteno account.
- Get Account Info
Return the Reteno organization and API user associated with the connected account. Use this to verify which account subsequent operations affect.
- Get Contact
Return the full Reteno profile for one contact identified by its internal contact ID.
- Get Contact Import Status
Return the current state and resulting contact IDs for an asynchronous Reteno contact import started by Upsert Contacts.
- List Address Books
Return Reteno contact address books and their assigned field groups and fields.
- List Contact Fields
List custom contact fields, their field IDs and keys, data types, allowed values, and validation metadata.
- List Contact Messages
Return one page of a contact's email, SMS, push, web push, or App Inbox message history for a required date range.
- List Contacts
List one bounded page of Reteno contacts. Optionally filter by external customer ID, email, phone, or name.
- List Segments
Search Reteno contact segments by name and return one bounded page with segment IDs and types.
- List Subscription Categories
List the organization's contact subscription categories and the keys used to manage communication preferences.
- List Workflows
Search Reteno automation workflows by name and return their IDs, status, and tags.
- Track Event
Send one non-retractable backend event for an identified contact. A new event type key is created after Reteno accepts its first event.
- Upsert Contact
Create or update a Reteno contact in real time and return its Reteno contact ID.
- Upsert Contacts
Create or update 1-3000 Reteno contacts asynchronously using one explicit deduplication strategy. Returns an import session ID and immediate failures.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add Integration', search for Reteno, and select it from the list. 3. Log in to your Reteno dashboard, go to Settings > API Keys, and generate a new key with read permissions for contacts, messages, and account data. 4. Copy the API key and paste it into the Switchy connection dialog, then click 'Connect'. 5. Switchy will verify the key by calling Get Account Info; you'll see your organization name if successful. 6. Open any Project, type '@Reteno get contact' in the chat, and provide a contact ID to confirm the integration responds with profile data.
What teammates see: by default, memories from Reteno are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Contact Profile Lookup
@Reteno get the contact profile for ID 987654321. Show me their email, phone, custom fields, and any tags.
Recent Message History
@Reteno list all messages sent to contact ID 987654321 in the past seven days. Include email, SMS, and push notifications.
Address Book Inventory
@Reteno list all address books in the account. For each one, show the field groups and custom fields it uses.
Account Balance Check
@Reteno get the account balance. Tell me the monetary balance, credit limit, currency, and how many prepaid emails and SMS we have left.
Import Job Status
@Reteno get the status of contact import job ID abc123. If it's complete, show me the contact IDs that were created or updated.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Reteno list all contacts whose email domain is @acme.com and show me their subscription status
Found 47 contacts with @acme.com email addresses in your Reteno workspace. The list includes contact IDs, names, email addresses, phone numbers, and current subscription status (subscribed, unsubscribed, or bounced). Of these, 39 are actively subscribed to marketing emails, 6 have unsubscribed, and 2 are marked as bounced. Each contact record also shows the date they were added to Reteno and their last activity timestamp. Note that this is a paginated result; if you have more than 100 matching contacts, you'll need to request subsequent pages.
This example uses List Contacts with email filtering. Reteno's API returns paginated results (typically 100 records per page), so large contact lists require multiple calls. The MCP needs a valid API key with read access to contacts. Filtering by domain requires partial-match support; check the MCP's implementation to confirm substring search works as expected.
@Reteno create a new contact for jane.doe@example.com with phone +1-555-0199, then add her to the 'Product Updates' address book
Contact created successfully. Reteno assigned internal contact ID `ret_c_8x7k2m` to jane.doe@example.com. The contact record now includes the phone number +1-555-0199 and default subscription status (subscribed). I've added this contact to the 'Product Updates' address book (book ID `ab_9f3j1`). The import operation is processing asynchronously; Reteno typically completes address book assignments within 30 seconds. You can check the import status with Get Contact Import Status if you need confirmation before sending a campaign.
This example chains Upsert Contacts with address book assignment. Reteno processes contact imports asynchronously, so the contact may not appear in campaigns immediately. The MCP requires API key permissions for both contact creation and address book management. Be aware that creating duplicate contacts (same email or phone) will update the existing record rather than create a new one.
@Reteno pull the last 30 days of email message history for contact ID ret_c_8x7k2m and summarize which campaigns had the highest open rates
Contact ret_c_8x7k2m received 12 email messages in the past 30 days. The message history shows campaign names, send timestamps, delivery status, open events, and click events. Three campaigns stand out: 'Weekly Digest #47' had a 68% open rate with 4 link clicks, 'Flash Sale Alert' achieved 55% open rate with 2 clicks, and 'Product Launch Announcement' reached 51% open rate with 6 clicks. The remaining 9 messages averaged 22% open rate. Two messages bounced due to a temporary mailbox-full error on days 12 and 13, but subsequent sends delivered successfully.
This example combines List Contact Messages with AI summarization to surface engagement patterns. Reteno's message history API requires a date range (maximum 90 days) and returns one channel at a time (email, SMS, push, etc.). The MCP must have read access to message logs. Open and click tracking depends on the contact's email client settings; some privacy features block tracking pixels.
Use-case deep-dives
When support needs full message history in one call
A six-person support team handling 200 tickets a day needs to see what emails and SMS a customer received before they opened the ticket. Reteno's List Contact Messages tool pulls the full timeline for a date range without switching tabs or logging into a separate dashboard. The Get Contact tool adds profile fields like subscription tier or last purchase date. This works when your support volume is low enough that agents can afford the extra 2-3 seconds to fetch history on demand. If you're triaging 50 concurrent chats, pre-caching message history in your helpdesk is faster. For teams under 10 agents who want context without a custom integration, Reteno's MCP gives you the lookup speed you need.
Why this MCP matters for pre-send list checks
A three-person marketing team at a SaaS company is about to send a product launch email to 12,000 contacts. Before hitting send, they want to confirm the address book actually excludes churned accounts and includes the new trial signups from last week. The List Address Books and List Contacts tools let them spot-check segment membership and field values in Switchy without exporting CSVs or opening the Reteno UI. The Get Contact Import Status tool confirms the morning's trial upload finished. This scenario breaks down if your contact list exceeds 50,000 rows—pagination makes manual verification slow. For small teams sending fewer than five campaigns a week, Reteno's MCP turns pre-flight checks into a 90-second Switchy conversation instead of a 10-minute UI drill.
When finance needs real-time spend visibility
A startup's finance lead wants to track Reteno spend weekly without waiting for the monthly invoice. The Get Account Balance tool returns prepaid SMS and email quotas, credit limits, and current balance in one call. The Get Account Info tool confirms which API user and organization the balance belongs to, which matters when you're managing multiple brands or subsidiaries. This is useful when your messaging volume is unpredictable—Black Friday spikes or a viral product launch can burn through prepaid credits fast. If your monthly spend is under $500 and stable, checking balance once a quarter in the Reteno dashboard is enough. For teams scaling fast or running tight budgets, Reteno's MCP gives you the weekly pulse check you need to avoid surprise overages.
Frequently asked
What does the Reteno MCP let Switchy do?
It connects Switchy to your Reteno customer engagement account so AI agents can read contact profiles, check message history across email and SMS channels, manage address books, and verify account balance and credit limits. Agents can't send campaigns or trigger messages—this MCP is read-only for customer data inspection and account monitoring.
Do I need admin access to connect Reteno?
You need an API key from your Reteno account settings. Reteno doesn't publish granular permission tiers for API keys, so whoever generates the key typically has full account access. If your org restricts API key creation to admins, you'll need one of them to provide it during Switchy setup.
Can the Reteno MCP send emails or SMS to contacts?
No. The fourteen tools are all read operations—fetching contact profiles, listing message history, checking account balance, and inspecting address book structure. If you need to trigger campaigns or send transactional messages, use Reteno's own dashboard or a separate automation platform that calls their send endpoints directly.
Why use this instead of logging into Reteno's web UI?
An AI agent can answer questions like "show me contacts who received SMS in the last week" or "what's our remaining prepaid quota" without you clicking through Reteno's interface. The MCP also lets you cross-reference Reteno data with other tools in Switchy—for example, matching contact IDs to support tickets.
Who on the team should connect the Reteno account?
Whoever owns your customer engagement workflows and has API key access. Marketing ops or a CRM admin are typical choices. Once connected, any Switchy teammate can ask agents to query Reteno data, but only the person who added the API key can rotate or revoke it from Switchy's integrations page.