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.
Step 1: Create your Virlo account for free
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_KEYin your shell profile, then restart Kiro so it can see the variable.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.
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": [] } } }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 promptUse 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?
| Location | Path | Sign-in | Choose it for |
|---|---|---|---|
| User config | ~/.kiro/settings/mcp.json | OAuth in the browser, or ${VIRLO_API_KEY} in headers | Having Virlo in every Kiro workspace |
| Workspace config | .kiro/settings/mcp.json in the project | Each teammate signs in or sets their own variable | Sharing Virlo with a team through the repo |
| Kiro CLI | Reads the same MCP settings as the IDE | Same as above | Terminal sessions and automated jobs |
| Steering file | .kiro/steering/virlo.md describing how to use Virlo | Uses the server you added | Teaching 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
| Task | Kiro alone | Kiro with Virlo |
|---|---|---|
| Spec a content dashboard | Requirements built on made-up data | Requirements grounded in real trend, hook and sound records |
| Suggest launch video formats | Generic patterns from the model | This week's trends to copy, with the part to keep and the part to change |
| Pick background audio | Songs from the model's memory | Reels and TikTok sounds counted over the last 7 days |
| Explain a competitor hit | A caption-based guess | Hook, 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
| Sound | Artist | Reels 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 Wizard | 75 |
Dilruba Dilnasheen | Rito Riba, Siddhant kaushal | 46 |
| Vintage November | Peaceful Reveries | 25 |
| What's Up - Deep house | HARDMAX | 24 |
| Saxophone Getting Louder | NDIOUGA KÉBÉ RECORDS | 22 |
See all 300 trending Reels sounds
Breakout sounds, usage history and the Reels behind each sound are in the Virlo app.
Open sounds in VirloHow 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.
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
- Google Antigravity
- goose
- Warp
- OpenCode
- Zed
- Amp
- Factory Droid
- Raycast
- Lovable
- Replit
- Bolt.new
- v0
- Ollama
- LM Studio
- Open WebUI
- LibreChat
- Make
- Pipedream
- Gumloop
- Lindy
- Relevance AI
- Airtable
- ClickUp
- Dify
- Flowise
- LangChain
- CrewAI
- OpenAI Agents SDK
- Mastra
- Vercel AI SDK
- Claude Agent SDK
