# How to connect Viral Loops to Grok Bot

```json
{
  "title": "How to connect Viral Loops to Grok Bot",
  "toolkit": "Viral Loops",
  "toolkit_slug": "viral_loops",
  "framework": "Grok Bot",
  "framework_slug": "grok-bot",
  "url": "https://composio.dev/toolkits/viral_loops/framework/grok-bot",
  "markdown_url": "https://composio.dev/toolkits/viral_loops/framework/grok-bot.md",
  "updated_at": "2026-11-06T06:01:07.733Z"
}
```

## Introduction

Grok is xAI's assistant, and its bot builder lets you create a personal agent that holds context, runs skills, and connects to the apps you already use through plugins.
This guide explains how to connect Viral Loops to a Grok bot using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a plugin, authenticate once, then ask your bot to work with Viral Loops in plain language.

## TL;DR

Composio exposes 1,500+ apps to your Grok bot through a single connection, so you get:
- Connect to 1,500+ apps with on-demand tool loading, so you do not fill your context window with unnecessary tool definitions.
- Use programmatic tool calling through a remote workbench, letting the model write its own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
- Handle large tool responses outside the model context to keep conversations lean.

## Connect Viral Loops to Grok Bot

### Connecting Viral Loops to Grok Bot
Once Grok Bot is set up, you connect Viral Loops entirely from its interface, and the whole flow takes under a minute.
### Set up Grok Bot
Get access. Grok Bot is included with Cursor Ultra, Cursor Premium Teams, and SuperGrok Heavy. Get the desktop app for macOS or Windows from [x.ai/bot](https://x.ai/bot) and sign in. An iPhone companion app is also available, and your bots sync across devices.
Create a bot. Pick a suggested role or define your own, then give it a short name, one primary job, and a short description of how it should work. Focused bots work best, because a clear role gives the bot more useful context over time.
### Connect Viral Loops
### 1. Add the Composio plugin
Click the button. The Composio listing on x.ai opens and launches Grok Bot for you. If the app does not open on its own, click Add to Grok Bot.
[Add to Grok Bot](https://x.ai/bot/plugin/32661537)
Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.
### 2. Authenticate
Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.
Click Authenticate. You'll be taken to the Composio consent screen. Review the access it requests and click Authorize. Composio handles the OAuth handshake for you, so you never touch API keys or tokens.
### 3. Connect your Viral Loops account
Back in the chat, ask your bot to connect to Viral Loops or give it any Viral Loops task.
For example, ask it to:
- "List top Viral Loops campaign referrers"
- "Show leaderboard for summer referral campaign"
- "Check pending referrals for campaign"
It will prompt you to authenticate and authorize access.
That's it. Composio's tools are now available in your Grok bot, and your Viral Loops account is ready to use.

## What is Grok Bot?

Grok is xAI's assistant, available as a chat interface and a bot builder for creating personal agents that run skills and connect to external apps.
With Composio Connect, your Grok bot can securely access apps like Viral Loops through MCP without you sharing account credentials directly with the agent.

## What is the Viral Loops MCP server, and what's possible with it?

The Viral Loops MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Viral Loops account. It provides structured and secure access to your referral campaigns and participant data, so your agent can review campaign performance, find participants, register and update participants, inspect referrals and rewards, and record conversions on your behalf.
- Campaign insights: Have your agent retrieve campaign details, configuration, expiration settings, lead counts, and total referral counts.
- Participant search: Let the agent find participants by text, conversion status, acquisition source, email address, or referral code.
- Referral and reward tracking: Direct your agent to review a participant's referrals, referral totals, campaign rank, referrer, and reward summaries.
- Participant registration and updates: Instruct your agent to register new campaign participants with optional referrer details, then update their names, referral counts, conversion counts, or custom data.
- Conversion recording: Have your agent record an irreversible conversion event for a registered participant when a qualifying action is completed.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `VIRAL_LOOPS_GET_CAMPAIGN_INFO` | Get Campaign Info | Return the connected campaign's identity, template, expiration mode and date, points, GDPR, and integration configuration without bulky presentation styling. |
| `VIRAL_LOOPS_GET_CAMPAIGN_STATS` | Get Campaign Stats | Return the connected campaign's lead count and total referral count. |
| `VIRAL_LOOPS_GET_PARTICIPANT` | Get Participant | Return one participant's profile, referral totals, rank, referrer, and reward summaries by email or referral code. |
| `VIRAL_LOOPS_LIST_PARTICIPANT_REFERRALS` | List Participant Referrals | Return one participant's referrals by email or referral code, with explicit offset pagination. The provider's response fields and pagination metadata are preserved as returned. |
| `VIRAL_LOOPS_LOOK_UP_PARTICIPANTS` | Look Up Participants | Batch lookup exact participant and referrer identifiers, returning matching campaign records with explicit offset pagination. |
| `VIRAL_LOOPS_REGISTER_PARTICIPANT` | Register Participant | Register an email address in the connected campaign, optionally with a referrer and participant metadata. This creates persistent participant data; Viral Loops provides no API operation to delete it. |
| `VIRAL_LOOPS_SEARCH_PARTICIPANTS` | Search Participants | Search campaign participants by text, conversion status, and acquisition source, with explicit offset pagination. |
| `VIRAL_LOOPS_TRACK_PARTICIPANT_CONVERSION` | Track Participant Conversion | IRREVERSIBLE: Record a conversion event for one registered participant. This operation cannot be undone and may affect conversion counts, campaign automation, and rewards. It is available only for Milestone Referral, Altruistic Referral, Online to Offline, and Universal Referral campaign templates; other templates reject it. Identify the participant by exactly one email or referral code, and optionally attach a numeric conversion value. |
| `VIRAL_LOOPS_UPDATE_PARTICIPANT` | Update Participant | Update one participant's name, referral or conversion counts, or custom data, identified by email or referral code. Campaign emails and connected integration triggers default to off; when enabled, those side effects cannot be undone. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

Once connected, your Grok bot can access the Viral Loops MCP server through Composio to run the actions you authorize, using plain language in the chat.

## Complete Code

None listed.

## Conclusion

### Way Forward
Now that Viral Loops is connected, extend your setup by connecting the other apps you already use every day, so your Grok bot can run true cross-app workflows end to end.
- Connect Calendar to turn threads into scheduled meetings automatically.
- Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
- Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
- Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.
Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, your bot can coordinate multiple tools safely and reliably in one conversation.

## How to build Viral Loops MCP Agent with another framework

None listed.

## Related Toolkits

- [Metaads](https://composio.dev/toolkits/metaads) - Metaads is Meta's official Ads API that lets you manage, analyze, and optimize your Facebook and Instagram ad campaigns. Streamline ad operations and gain deeper insights with robust automation.
- [Adrapid](https://composio.dev/toolkits/adrapid) - Adrapid is a platform for rapid creation of digital marketing visuals using templates. It streamlines design workflows for banners, images, and HTML5 content with automation.
- [Adtraction](https://composio.dev/toolkits/adtraction) - Adtraction is an affiliate marketing platform for partner programs, tracking links, transactions, commissions, statistics, and payments. It helps advertisers and publishers manage performance marketing with clear reporting and payout workflows.
- [Adyntel](https://composio.dev/toolkits/adyntel) - Adyntel is an API that retrieves LinkedIn ads for any company using a domain or LinkedIn Page ID. Easily access competitive ad intelligence to power your marketing workflows.
- [Beaconstac](https://composio.dev/toolkits/beaconstac) - Beaconstac is a platform for creating and managing QR codes and proximity beacons. It helps businesses engage customers and track marketing performance with powerful analytics.
- [Bouncify](https://composio.dev/toolkits/bouncify) - Bouncify is an email verification service for single addresses and bulk lists. Use it to reduce bounces, protect sender reputation, and track verification credits.
- [Bulk Email Checker](https://composio.dev/toolkits/bulk_email_checker) - Bulk Email Checker is an email verification service for checking address validity, mailbox status, domains, and mail-server signals. It helps reduce bounces, spot risky emails, and keep outreach lists cleaner before you send.
- [Campaign cleaner](https://composio.dev/toolkits/campaign_cleaner) - Campaign cleaner is an email campaign optimization tool that boosts compatibility and deliverability across email clients. It helps marketers get better results by cleaning, enhancing, and ensuring high performance for every campaign.
- [Deadline funnel](https://composio.dev/toolkits/deadline_funnel) - Deadline Funnel lets you create personalized deadlines and timers for your marketing campaigns. It helps marketers boost conversions by adding authentic urgency to offers.
- [DeBounce](https://composio.dev/toolkits/debounce) - DeBounce is an email verification service for checking address validity, deliverability, and risk. It helps keep contact lists clean so your campaigns reach real inboxes.
- [Easy Email Verification](https://composio.dev/toolkits/easy_email_verification) - Easy Email Verification is an email validation service for checking single addresses and bulk lists. Use it to reduce bounces, clean contact data, and protect sender reputation.
- [GoDaddy MCP](https://composio.dev/toolkits/godaddy_mcp) - GoDaddy MCP is a domain discovery toolkit for checking availability and generating AI-powered name ideas. Use it to move from rough business keywords to practical domain options fast.
- [Google Ads](https://composio.dev/toolkits/googleads) - Google Ads is Google's online advertising platform for creating, managing, and optimizing digital campaigns. It helps businesses reach targeted customers and maximize return on ad spend.
- [Google AdSense](https://composio.dev/toolkits/google_adsense) - Google AdSense is a platform for managing website advertising, payments, and performance reports. It helps publishers monetize content and track ad revenue in one place.
- [Handwrite.io](https://composio.dev/toolkits/handwrite) - Handwrite.io is a direct mail service for creating physical handwritten card orders. It helps teams send personal cards with selectable handwriting, stationery, and tracking.
- [Instantly](https://composio.dev/toolkits/instantly) - Instantly is a platform for automating cold email outreach, managing leads, and optimizing deliverability. Get better results from email campaigns with minimal manual effort.
- [Keyword](https://composio.dev/toolkits/keyword) - Keyword.com is a digital marketing platform for search rank tracking and SEO analytics. Use it to monitor keyword performance, spot ranking changes, and measure SEO visibility.
- [Linkedin Ads](https://composio.dev/toolkits/linkedin_ads) - Linkedin Ads is LinkedIn's marketing platform for creating, managing, and measuring paid campaigns across LinkedIn. It helps teams reach professional audiences with precise targeting, campaign analytics, and sponsored content tools.
- [Microsoft Advertising](https://composio.dev/toolkits/microsoft_advertising) - Microsoft Advertising is Microsoft's platform for managing search advertising campaigns across Bing and partner sites. It provides campaign controls, audience targeting, bidding, and performance reporting in one place.
- [Pinterest Ads](https://composio.dev/toolkits/pinterest_ads) - Pinterest Ads is Pinterest's advertising platform for campaigns, ad groups, ads, targeting, and reporting. Use it to reach high-intent shoppers and track performance across the Pinterest funnel.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Viral Loops MCP?

With a standalone Viral Loops MCP server, the agents and LLMs can only access a fixed set of Viral Loops tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Viral Loops and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Grok Bot?

Yes, you can. Grok Bot fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Viral Loops tools.

### Can I manage the permissions and scopes for Viral Loops while using Tool Router?

Yes, absolutely. You can configure which Viral Loops scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Viral Loops data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)