viralquery

ViralQuery

Use ViralQuery to answer: “Get the top viral videos for this mobile app.”

Workflow

1. Use the ViralQuery MCP tools. If unavailable, tell the user how to connect https://viralquery.com/mcp; never ask them to paste a key into chat.
2. Prefer an Apple App Store link. Extract its numeric ID, call listApps, and use an exact matching id or appStoreUrl. For a name-only request, use an unambiguous listed match; never invent an ID.
3. If listed, call getAppVideos once with that exact ID.
4. If missing and the user supplied an App Store link, call requestApp with the full link. This is Max-only and uses the account's bounded new-app allowance.
5. For queued or joined, call getAppRequest with the returned request ID. Poll at a bounded interval while practical. When ready, call getAppVideos with the returned app ID. If work is still running, report the status and request ID instead of claiming completion.
6. Cite each returned source URL and video ID. Report only the data that ViralQuery returns; clearly label any synthesis as your inference.
7. Filter or sort returned fields locally when needed. Return a focused answer for the requested app rather than broad, unrelated inspiration.

The MCP exposes listApps, getAppVideos, requestApp, and getAppRequest. Do not look for catalog writes, ingestion controls, or maintenance tools.

Read references/operations.md when exact tool inputs or protected connection setup matter.