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.

  1. Step 1: Create your Virlo account for free

    Create your free Virlo account in under a minute. Already signed up? Open API Keys.
  2. Step 2: Add Virlo under mcpServers in librechat.yaml

    Open librechat.yaml on your server and add this block. Set type: streamable-http explicitly, 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.yaml
    mcpServers:
      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: true
  3. Step 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.

    Terminal
    docker compose restart
  4. Step 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.

  5. 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 prompt
    Use 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?

SetupIn librechat.yamlWho enters the keyBest for
Per-user keyAuthorization: 'Bearer {{VIRLO_API_KEY}}' plus a customUserVars entryEvery user, once, from MCP Servers or MCP SettingsTeams where each person has a Virlo account
Shared server keyAuthorization: 'Bearer ${VIRLO_API_KEY}' read from the server's environmentThe admin, in the deployment envOne shared research account for everyone
Hidden from the chat menuchatMenu: false on the serverEither of the aboveWhen 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

What TikTok trends would a LibreChat agent pull today?
TrendStageCreators this weekCreators last week
Example video for the My moon my man couple montage trend by @haleyybayleeMy moon my man couple montageFresh659new this week
Example video for the While they're out partying btw trend by @larpniverseWhile they're out partying btwRising346115
Example video for the He wanna pay full price SNL trend trend by @anereslaila1He wanna pay full price SNL trendFresh175new this week
Example video for the But you're not a Buddhist trend trend by @nicolo.contradaBut you're not a Buddhist trendFresh15833
Example video for the Shoulder carry mirror selfie trend trend by @thecapcutterxShoulder carry mirror selfie trendFresh158new 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 copy

How 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: false is 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.