Kiro MCP setup: research TikTok and Instagram in the Kiro IDE

Updated

Virlo is social listening for TikTok and Instagram Reels. Kiro turns a prompt into specs, tasks and working code, but its agent has no view of what TikTok and Instagram audiences are watching this week. Add Virlo to Kiro's mcp.json and the agent can bring trends, hooks, sounds and outlier videos from a database of 23.1M viral videos into chats and specs. Kiro is AWS's spec-driven agentic IDE and CLI, which AWS points Amazon Q Developer IDE users to as their next tool.

  • One url entry in ~/.kiro/settings/mcp.json or .kiro/settings/mcp.json
  • Kiro handles the Virlo sign-in in your browser, or reads your key from the environment
  • Use Virlo in vibe chats and inside spec tasks

Part of Virlo's AI assistant guides. Comparing AI editors? See Cursor and VS Code.

How do I add an MCP server to Kiro?

Kiro reads MCP servers from a JSON file at user or workspace level. Add the Virlo entry, and Kiro connects as soon as you save.

  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: Optional: set VIRLO_API_KEY

    Prefer a key to a browser sign-in? Make one on the Virlo API Keys page (it starts with virlo_tkn_) and export it as VIRLO_API_KEY in your shell profile, then restart Kiro so it can see the variable.

  3. Step 3: Open the Kiro MCP config

    Press Cmd/Ctrl + Shift + P, search MCP and choose Kiro: Open user MCP config (JSON) to use Virlo in every workspace, or Kiro: Open workspace MCP config (JSON) for this project only. The Open MCP Config icon in the Kiro panel does the same.

  4. Step 4: Paste the Virlo entry

    Add this under mcpServers and save. Kiro swaps ${VIRLO_API_KEY} for the value in your environment. Skipped the key? Delete the headers block and Kiro runs the Virlo OAuth flow in your browser instead.

    ~/.kiro/settings/mcp.json
    {
      "mcpServers": {
        "virlo": {
          "url": "https://dev.virlo.ai/api/mcp/mcp",
          "headers": {
            "Authorization": "Bearer ${VIRLO_API_KEY}"
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }
  5. Step 5: Check the server and ask Kiro

    Open the MCP Servers section of the Kiro panel and confirm virlo is connected with its tools listed. Then start a vibe chat and ask.

    Your first prompt
    Use Virlo to find the 10 TikTok trends to copy with the most creators in [your niche] this week and save them to research/trends.md with an example video for each.

Workspace config overrides user config when both define virlo, which lets one repo point at a different key from the rest of your projects.

User config vs workspace config vs Kiro CLI: where should Virlo go?

LocationPathSign-inChoose it for
User config~/.kiro/settings/mcp.jsonOAuth in the browser, or ${VIRLO_API_KEY} in headersHaving Virlo in every Kiro workspace
Workspace config.kiro/settings/mcp.json in the projectEach teammate signs in or sets their own variableSharing Virlo with a team through the repo
Kiro CLIReads the same MCP settings as the IDESame as aboveTerminal sessions and automated jobs
Steering file.kiro/steering/virlo.md describing how to use VirloUses the server you addedTeaching Kiro to rank by Virality Score and cite source videos

Set "disabled": true on the entry to pause Virlo without deleting it.

Kiro without Virlo vs Kiro with Virlo

TaskKiro aloneKiro with Virlo
Spec a content dashboardRequirements built on made-up dataRequirements grounded in real trend, hook and sound records
Suggest launch video formatsGeneric patterns from the modelThis week's trends to copy, with the part to keep and the part to change
Pick background audioSongs from the model's memoryReels and TikTok sounds counted over the last 7 days
Explain a competitor hitA caption-based guessHook, on-screen text, format and Virality Score against the creator's usual views

Which Instagram Reels sounds would Kiro pull from Virlo today?

Here is the live list of Reels sounds ranked by how many Reels used them in the last 7 days. Kiro can save it to a file or fold it into a spec task about your next video.

In Virlo's data, 75 Reels used "Flower In A Hurricane (feat. Tame Impala, SZA, King Gizzard & the Lizard Wizard) [From GTAVI: Original Score]" in the last 7 days, more than any other sound on Instagram as of November 19, 2026.

As of November 19, 2026 at 12:03 UTC

Which Instagram Reels sounds would Kiro pull from Virlo today?
SoundArtistReels using it (7 days)
Flower In A Hurricane (feat. Tame Impala, SZA, King Gizzard & the Lizard Wizard) [From GTAVI: Original Score]Justice, Tame Impala, SZA, King Gizzard & the Lizard Wizard75
Cover art for Dilruba DilnasheenDilruba DilnasheenRito Riba, Siddhant kaushal46
Vintage NovemberPeaceful Reveries25
What's Up - Deep houseHARDMAX24
Saxophone Getting LouderNDIOUGA KÉBÉ RECORDS22

See all 300 trending Reels sounds

Breakout sounds, usage history and the Reels behind each sound are in the Virlo app.

Open sounds in Virlo

How this sample is made

Source
Virlo's sound rankings for Instagram Reels, built from the Reels Virlo collects.
Window
Reels posted in the last 7 days that Virlo collected. Counts are Reels in Virlo's data, not every Reel on Instagram.
Method
Ranked by the number of Reels using each sound in the window.
As of
November 19, 2026 at 12:03 UTC. Rebuilt every day.
Made by
Numbers are pulled automatically from Virlo's data; the text around them is written by the Virlo team.

Suggested citation: Source: Virlo, “Kiro MCP setup: research TikTok and Instagram in the Kiro IDE”, virlo.ai/kiro

Using Virlo inside Kiro specs

Kiro's spec mode writes requirements, a design and a task list before it codes. With Virlo connected, those documents can rest on real social data instead of assumptions, which matters when the thing you are building is a content tool, a campaign page or a creator feature.

  • Start a spec such as "a weekly trend digest page for [your niche]" and ask Kiro to call Virlo while drafting requirements.
  • Let the design document reference the actual fields a Virlo trend record contains.
  • Have one task fetch fresh data, so running the task list again refreshes the page content.
  • Add a steering file that says "always cite the source video and sort by Virality Score" so every chat follows it.
  • Ask Kiro to turn the finished spec into a short brief your content team can read without opening the IDE.

Virality Score measures how far a video outperformed its creator's usual views, with 18 or more counting as strong. It lets Kiro spot a small creator's breakout, not only the biggest accounts.

Moving from Amazon Q Developer to Kiro with Virlo

AWS announced in April 2026 that the Amazon Q Developer IDE plugins reach end of support on 30 April 2027 and pointed users to Kiro for agentic coding, chat and MCP. If your team is making that move, Virlo comes along with one config entry.

Q Developer users who set up MCP servers earlier can copy each server into Kiro's mcp.json. Virlo uses the hosted URL, so there is nothing to reinstall: paste the block above and sign in.

Kiro hooks for recurring research

Hooks are where Kiro starts to feel like a research assistant that works in the background. You set the trigger and the instruction once, and the agent repeats the check every time the trigger fires.

Kiro agent hooks run a prompt when something happens in your workspace, such as saving a file. A hook on your content calendar file can ask the agent to check each planned topic against live Virlo trends and flag any idea with no matching video that is performing.

Because the hook runs inside Kiro with the same MCP config, it uses the Virlo entry you already added. Keep the hook prompt short and specific, and have it write its findings to a review file rather than editing your calendar directly.

What can I ask Kiro to do with Virlo?

Paste into a vibe chat or a spec task. Replace each bracket.

  • Trend digest

    Create research/digest-[date].md with this week's TikTok and Instagram trends to copy in [your niche], one source video per trend.

  • Spec with real data

    Draft requirements for a [feature] that shows trending sounds, using live Virlo data to define the fields.

  • Hook breakdown

    Find TikTok videos about [topic] with a Virality Score of 18+ and group their spoken hooks by hook type in docs/hooks.md.

  • Reels audio

    List the top five Instagram Reels sounds this week and suggest which one fits a [tone] video for [your brand].

  • Rival check

    Look up @[competitor] on Instagram with Virlo and summarise the Reels that beat their usual views.

  • Script draft

    Get the transcript of [TikTok link] and adapt its structure into a 30-second script for [your product].

  • Creator list

    Find 10 creators under [N] followers in [your niche] whose videos keep outperforming their size and save them to data/creators.json.

  • Steering file

    Write .kiro/steering/virlo.md telling Kiro to use Virlo for any social media question, sort by Virality Score and always link source videos.

Kiro vs Amazon Q Developer: which one should I set up?

Both come from AWS, and the names often appear together in migration guides.

Kiro (this page)

AWS's spec-driven agentic IDE and CLI, with MCP servers configured in mcp.json files under .kiro/settings.

Amazon Q Developer

The earlier AWS coding assistant. Its IDE plugins stopped taking new sign-ups in May 2026 and reach end of support on 30 April 2027.

Cursor

An AI editor from Anysphere that keeps MCP servers in ~/.cursor/mcp.json.

VS Code

Microsoft's editor, which Kiro is built on; its agent reads MCP servers from .vscode/mcp.json.

What are the limits?

  • Virlo reads public TikTok and Instagram data only and never connects to social accounts, so Kiro can research with it but not post.
  • The autoApprove list skips Kiro's confirmation for listed tools; leave it empty if you want to approve each Virlo call.
  • Environment variables are read when Kiro starts, so restart it after setting VIRLO_API_KEY.
  • Trends to copy refresh hourly and are checked by the Virlo team first.
  • For what each Virlo plan includes, see pricing.

Frequently asked questions

How do I add an MCP server to Kiro?

Open the command palette, choose Kiro: Open user MCP config (JSON) and add an entry under mcpServers. For Virlo, set "url": "https://dev.virlo.ai/api/mcp/mcp" and either an Authorization header or nothing else for a browser sign-in. Save and the server appears in the Kiro panel.

Where is the Kiro mcp.json file?

User-level servers live in ~/.kiro/settings/mcp.json and apply to every workspace. Workspace servers live in .kiro/settings/mcp.json inside the project and only apply there. Both use the same mcpServers format. When the same server name appears in both, the workspace entry wins for that project.

Does Kiro support remote MCP servers with OAuth?

Yes. Kiro connects to remote servers by URL and handles OAuth automatically, opening the provider's sign-in in your browser. Virlo supports that flow, so a url-only entry is enough; headers are only needed if you would rather use an API key.

Is Kiro replacing Amazon Q Developer?

For the IDE, yes. AWS stopped new Q Developer IDE sign-ups in May 2026, set end of support for the IDE plugins at 30 April 2027, and recommends Kiro for similar capabilities, including chat, agentic coding and MCP support. Teams moving across can add Virlo to Kiro with the same server URL they would use anywhere else.

Can Kiro see TikTok and Instagram data?

Once Virlo is in its MCP config, Kiro can fetch trends to copy, outlier videos ranked by Virality Score, hooks, sounds, hashtags, creators and TikTok transcripts, and use them in chats, specs and generated files. Each result points to its source video, so a spec built on it can be checked by anyone on the team.

How do I use environment variables in Kiro MCP config?

Write ${VARIABLE_NAME} anywhere in the entry and Kiro substitutes the value from your environment. For Virlo, "Authorization": "Bearer ${VIRLO_API_KEY}" keeps the key out of the file, which matters for a workspace config that gets committed. Restart Kiro after changing the variable so it reads the new value.

Virlo is not connecting in Kiro. What should I check?

Look at the MCP Servers section of the Kiro panel for the error. Check that the JSON is valid, the URL ends in /mcp with no trailing slash, "disabled" is false, and VIRLO_API_KEY was set before Kiro launched. Then reconnect the server.

Can Kiro publish videos through Virlo?

No. Virlo is a research source with no posting or account access. Kiro can analyse data, draft scripts and build tools around it, and the actual posting happens in your social apps. Kiro needs no social login to run its research tasks.

Can I use Virlo in Kiro spec mode?

Yes. Spec mode can call MCP tools while it drafts requirements, design and tasks, so ask Kiro to check Virlo as it writes. Requirements for a content feature then name real fields and real examples, and a task in the list can refresh the data whenever you rerun it.

Ground your Kiro specs in real social data

Add one Virlo entry to mcp.json and ask Kiro what your niche is copying this week.