LibreChat MCP: add live TikTok and Instagram research to every chat
Updated
Virlo is social listening for TikTok and Instagram Reels. LibreChat can route your team to many models, but none of them can tell which TikTok trends are gaining creators this week. Declare Virlo in librechat.yaml as a streamable-http MCP server and every user can pull live trends, hooks, sounds and outlier videos into chats and agents with their own key. LibreChat is an open-source, self-hosted AI chat platform that brings many model providers, agents and MCP tools into one interface.
- One `mcpServers` block in librechat.yaml
- Per-user Virlo keys through customUserVars
- Available in chats and in the Agent Builder
Part of Virlo's AI assistant guides. Prefer an admin screen to YAML? See Open WebUI. Want the raw server details? See the Virlo MCP server.
How do I add an MCP server to LibreChat?
Whoever runs your LibreChat instance adds one YAML block. Each user then enters their own Virlo key the first time they connect.
Step 1: Create your Virlo account for free
Step 2: Add Virlo under mcpServers in librechat.yaml
Open librechat.yaml on your server and add this block. Set
type: streamable-httpexplicitly, because LibreChat treats an https URL without a type as SSE. The{{VIRLO_API_KEY}}placeholder is filled with each user's own key at runtime.librechat.yamlmcpServers: virlo: type: streamable-http url: https://dev.virlo.ai/api/mcp/mcp timeout: 60000 headers: Authorization: 'Bearer {{VIRLO_API_KEY}}' customUserVars: VIRLO_API_KEY: title: 'Virlo API key' description: 'Create one at dev.virlo.ai/dashboard/api-keys' sensitive: trueStep 3: Restart LibreChat
LibreChat reads librechat.yaml at start-up, so restart the stack after saving. On a Docker install that is a single command.
Terminaldocker compose restartStep 4: Each user pastes their Virlo key
In the chat composer, open MCP Servers, choose Virlo and enter a key from the Virlo developer dashboard when prompted. Users can change it later from Configure in the composer or from MCP Settings.
Step 5: Select Virlo and ask
Pick Virlo in the MCP Servers section of the composer, choose a model with good tool use and ask. Agents built in LibreChat can also add Virlo as a tool.
Your first promptUse Virlo to list the 5 TikTok trends to copy with the most new creators in [your niche] this week, with the part to keep, the part to change and one example video each.
Want one shared key instead? Replace {{VIRLO_API_KEY}} with ${VIRLO_API_KEY} and set that variable in LibreChat's server environment. Per-user keys keep usage tied to each person, which most teams prefer.
Per-user key vs shared key: how should LibreChat hold Virlo credentials?
| Setup | In librechat.yaml | Who enters the key | Best for |
|---|---|---|---|
| Per-user key | Authorization: 'Bearer {{VIRLO_API_KEY}}' plus a customUserVars entry | Every user, once, from MCP Servers or MCP Settings | Teams where each person has a Virlo account |
| Shared server key | Authorization: 'Bearer ${VIRLO_API_KEY}' read from the server's environment | The admin, in the deployment env | One shared research account for everyone |
| Hidden from the chat menu | chatMenu: false on the server | Either of the above | When only agents, not plain chats, should use Virlo |
LibreChat excludes servers with customUserVars from app-level connections, so each user's key is resolved only when that user calls Virlo.
What TikTok trends would a LibreChat agent pull today?
Ask a LibreChat chat or agent for what is trending and Virlo returns a list like this: TikTok trends ranked by how many creators are posting them right now.
In Virlo's tracking of 39 live trends to copy, "My moon my man couple montage" leads TikTok this week with 659 creators posting it as of November 19, 2026.
As of November 19, 2026 at 13:07 UTC
| Trend | Stage | Creators this week | Creators last week |
|---|---|---|---|
| Fresh | 659 | new this week | |
| Rising | 346 | 115 | |
| Fresh | 175 | new this week | |
| Fresh | 158 | 33 | |
| Fresh | 158 | new this week |
See all 39 trends to copy
Recipes, 30-day charts, client fit and every example video are in the Virlo app.
Open Trends to copyHow this sample is made
- Source
- Virlo's Trends to copy: formats found by Virlo's trend detector and published only after the team checks each one.
- Window
- Creators who posted each trend in the last 7 days, counted from TikTok and Instagram videos only. Trends made with an AI tool are left out.
- Method
- Ranked by creators posting this week. Stages: Fresh, Rising, Peaking, Fading.
- As of
- November 19, 2026 at 13:07 UTC. Refreshes every hour.
- Made by
- Numbers are pulled automatically from Virlo's data every hour; the text around them is written by the Virlo team.
Suggested citation: Source: Virlo, “LibreChat MCP: add live TikTok and Instagram research to every chat”, virlo.ai/librechat
How do LibreChat agents use Virlo?
LibreChat's Agent Builder lets you bundle a model, instructions and tools into a reusable agent. Add Virlo's MCP tools to an agent and you get a dedicated social researcher the whole organisation can pick from the agent list.
Agents worth building:
- A trend scout whose instructions say to start every answer from this week's Virlo data in [your niche].
- A script writer that fetches a TikTok transcript through Virlo and rewrites it for your product.
- A competitor analyst that checks named handles on TikTok and Instagram and reports their outliers.
- A sound matcher that pairs drafts with rising Reels and TikTok audio.
Set chatMenu: false on the Virlo server if you want it available only to these agents and hidden from ordinary chats.
Where does the Virlo key live in LibreChat?
With customUserVars, each user's key is stored by LibreChat against their account and swapped into the {{VIRLO_API_KEY}} placeholder only when they call Virlo. Marking the variable sensitive: true keeps it masked in the interface.
Never write a real key into librechat.yaml itself; the file is usually committed alongside your deployment, and anyone who can read it would see the key.
What if Virlo does not appear in LibreChat?
LibreChat loads MCP servers when it starts, so most issues show up in the server logs right after a restart:
- The type line is missing, so LibreChat tried SSE: add
type: streamable-http. - The YAML indentation is off by a space, which hides the whole block.
- LibreChat was not restarted after the file changed.
chatMenu: falseis set, so Virlo only appears in agents.- The user has not entered a key yet: open MCP Servers in the composer and add it.
How do I roll Virlo out to a LibreChat team?
Start with the YAML block on a staging copy of your LibreChat stack, restart it and confirm Virlo appears in the MCP Servers section of the composer. Then ship the same librechat.yaml change to production in your normal deploy.
Next, tell users where to paste their key. A short internal note with a link to the Virlo API Keys page and a screenshot of the Configure button is usually enough. Build one shared agent in the Agent Builder, such as a trend scout with Virlo tools and your brand instructions, so people have a ready-made starting point instead of a blank chat.
Finally, pick a default model for that agent that handles tools reliably. LibreChat lets each agent carry its own model, so the Virlo agent can use a strong tool-calling model while everyday chats stay on whatever your team prefers.
What can I ask LibreChat with Virlo connected?
Select Virlo in MCP Servers, or use an agent with Virlo tools, then paste one. Replace the brackets.
Trend list
Use Virlo to show the TikTok trends to copy with the most creators in [your niche] this week and their stage.
Content plan
Plan five posts for [your brand] next week from live Virlo trend data, each with the source video and the part to change.
Transcript rewrite
Fetch the transcript of [TikTok link] with Virlo and rewrite it as a 30-second script for [your product].
Outlier hunt
Find [topic] videos on TikTok and Instagram with a Virality Score of 18 or more and explain what they share.
Competitor brief
Use Virlo to check @[competitor] on TikTok and Instagram and list their videos that beat their usual views this month.
Sound pairing
Which sounds are trending on TikTok and Instagram Reels this week according to Virlo? Match one to each of my three drafts: [drafts].
Creator scout
Use Virlo to find 10 creators under [N] followers in [your niche] who keep outperforming their follower count.
LibreChat vs Open WebUI vs ChatGPT: which should I read?
All three give you a chat window with tools, but they are set up very differently.
LibreChat (this page)
Open-source and self-hosted, configured in librechat.yaml, with per-user MCP credentials and an Agent Builder.
Open WebUI
Also self-hosted, but MCP servers are added by an admin under External Tool Servers in the web interface.
ChatGPT
OpenAI's hosted assistant, where Virlo is added as an app in developer mode.
Ollama
A local model runner LibreChat can use as one of its providers; the Virlo tools still live in LibreChat.
What are the limits?
- Virlo is a read-only view of public TikTok and Instagram data, so LibreChat can research and write with it but cannot post or sign in to social accounts.
- The server is declared in librechat.yaml by whoever hosts LibreChat; ordinary users only add their key.
- Tool use depends on the model: pick one with dependable function calling for Virlo-heavy chats and agents.
- Trends to copy update hourly and sound rankings daily, which sets how fresh any LibreChat answer can be.
- Plans and what they include: pricing.
Frequently asked questions
Does LibreChat support MCP servers?
Yes. LibreChat reads MCP servers from the mcpServers section of librechat.yaml and supports stdio, SSE and streamable-http transports. Configured servers appear in the MCP Servers section of the chat composer and can be added as tools to agents. Virlo uses streamable-http.
How do I add an MCP server in librechat.yaml?
Add an entry under mcpServers with type: streamable-http, url: https://dev.virlo.ai/api/mcp/mcp and an Authorization header. Use a customUserVars placeholder for per-user keys, save the file and restart LibreChat so it loads the new server. Users then find Virlo in the composer.
Why does LibreChat need type: streamable-http?
When an https URL has no type, LibreChat assumes the older SSE transport. Virlo's server speaks Streamable HTTP, so setting the type explicitly is what makes the connection succeed. Without it, LibreChat tries the wrong transport and the server never appears as connected in the MCP Servers list, which is the most common setup mistake.
How do users enter their own API key in LibreChat?
Declare the key under customUserVars and reference it as {{VIRLO_API_KEY}} in the header. Each user is asked for it when they first connect to Virlo, and can change it later through Configure in the composer or MCP Settings. Mark it sensitive to mask it.
Can LibreChat agents use MCP tools?
Yes. In LibreChat's Agent Builder you can add tools from configured MCP servers, so an agent can call Virlo's research tools alongside its instructions and model. Setting chatMenu: false hides a server from plain chats while agents keep access. Agents share easily across the team.
Can LibreChat see TikTok trends?
With Virlo connected, yes. Chats and agents can read TikTok trends to copy, outlier videos ranked by Virality Score, sounds, hashtags, creators and transcripts, then turn them into plans or scripts. Every result includes links to the source videos, so a LibreChat answer can be checked against the real TikTok post before anyone acts on it.
Should LibreChat use one shared Virlo key or one per user?
Per-user keys, set with customUserVars, keep each person's usage separate and are the usual choice. A shared key, read from the server environment with the ${VAR} syntax, suits a single research account that the whole team uses. You can switch later by editing one header.
Can LibreChat post to TikTok with Virlo?
No. Virlo only reads public data and has no access to social accounts, so LibreChat can research and draft with it while your team handles posting elsewhere. No social account passwords ever pass through librechat.yaml, which keeps the deployment easy to secure and simple to approve internally.
LibreChat MCP server for TikTok: what does Virlo add?
Virlo adds read-only research tools over public TikTok and Instagram data to LibreChat: trends to copy, outlier videos ranked by Virality Score, hooks, sounds, hashtags, creators and TikTok transcripts. Declare it once in librechat.yaml and it serves plain chats and Agent Builder agents alike, each user on their own key.
Bring live social data into LibreChat
Add one block to librechat.yaml and every chat and agent can ask Virlo what is working.
More AI assistant guides
- AI assistant guides
- Claude
- Claude Code
- Cursor
- MCP server
- TikTok MCP server
- Instagram MCP server
- ChatGPT
- ChatGPT dots
- OpenAI Codex
- Gemini CLI
- Grok Build
- Claude Cowork
- n8n
- Zapier
- Grok Bot
- Muse
- Claude Duet
- Hermes Agent
- Kimi K3
- Cue
- Manus
- Perplexity Computer
- Paperclip
- OpenClaw
- NanoClaw
- DeepSeek
- AI agents CLI
- ChatGPT agent
- Perplexity
- Microsoft Copilot
- Le Chat
- Notion
- Slack
- Discord
- Telegram
- Google Sheets
- Windsurf
- VS Code
- GitHub Copilot
- Cline
- JetBrains
- Kiro
- Google Antigravity
- goose
- Warp
- OpenCode
- Zed
- Amp
- Factory Droid
- Raycast
- Lovable
- Replit
- Bolt.new
- v0
- Ollama
- LM Studio
- Open WebUI
- Make
- Pipedream
- Gumloop
- Lindy
- Relevance AI
- Airtable
- ClickUp
- Dify
- Flowise
- LangChain
- CrewAI
- OpenAI Agents SDK
- Mastra
- Vercel AI SDK
- Claude Agent SDK