# HYVIRAL

> Content intelligence, media generation and hosted video rendering for AI agents.
> Connect your agent over MCP and it can read your profile’s real performance data,
> generate images, video, voice and music, and render finished video — all metered
> in credits, with a price quoted and confirmed before anything is spent.

## MCP server

- Endpoint: https://api.hyviral.com/mcp
- Transport: Streamable HTTP, MCP protocol 2025-06-18
- Auth: OAuth 2.1 with PKCE (RFC 9728 protected-resource metadata), or a personal access token
- Protected-resource metadata: https://api.hyviral.com/.well-known/oauth-protected-resource
- Authorization server metadata: https://api.hyviral.com/.well-known/oauth-authorization-server

## Scopes

- `intel:read` — read content intelligence (profile stats, posts, trends, competitor digests)
- `research:run` — run web and saved research
- `creative:generate` — generate images, video, voiceovers and music
- `edit:render` — trim, caption, restyle and render video
- `uploads:write` — upload the agent's own footage and images
- `jobs:read` — track and cancel background jobs
- `account:read` — read the user's plan, goals and content settings, and the model catalog
- `account:write` — link and verify profiles, manage the calendar, watchlist and content settings, and record publish outcomes
- `feedback:write` — file a bug report

## How spending works

- Every tool that spends credits QUOTES first: the first call returns a price and a
  single-use confirmation token, and nothing is charged. The second call carries the
  token and executes. The quote is a ceiling, enforced server-side.
- Long jobs (video generation, rendering) return a job handle immediately. Poll
  `get_job_status`; do not re-issue the call.
- Video exports run up to 60 minutes, or 90 minutes on Pro and Hype. A longer project is refused at the quote, before anything is charged.
- Read tools are free. Generation tools that run an internal AI pass fold its cost
  into the quote you were shown — never a second charge — and the final total is
  often lower than the quote.
- A quote is valid for 10 minutes.
- Per-credential daily ceiling: the larger of 50,000 credits or 20% of the monthly grant.
- 1 credit = $0.002.

## Platforms

- youtube, instagram, tiktok, facebook

## Plans

- **Connect** — $29/mo, 12,000 credits ($0.00242/credit), 1 profile. Understand what works on your channel. Give your agent the tools to create more of it.
- **Pro** — $79/mo, 50,000 credits ($0.00158/credit), 3 profiles. Three profiles, the competitor watchlist and the deeper daily digest.
- **Hype** — $129/mo, 80,000 credits ($0.00161/credit), 5 profiles. Five profiles and the largest credit grant.

- Machine-readable pricing: https://hyviral.com/pricing.json

## Generation models

- 10 video models and 7 image models, each with its own price and limits — listed with prices in llms-full.txt and as `models` in pricing.json.

## Docs

- MCP overview: https://hyviral.com/docs/mcp (Markdown: https://hyviral.com/docs/mcp.md)
- Tool reference: https://hyviral.com/docs/mcp/tools (Markdown: https://hyviral.com/docs/mcp/tools.md)
- Connect from Claude, ChatGPT and Claude Code: https://hyviral.com/docs/mcp/connect (Markdown: https://hyviral.com/docs/mcp/connect.md)
- Auth and scopes: https://hyviral.com/docs/mcp/auth (Markdown: https://hyviral.com/docs/mcp/auth.md)
- Credits and pricing: https://hyviral.com/docs/mcp/credits (Markdown: https://hyviral.com/docs/mcp/credits.md)
- Bring your own footage: https://hyviral.com/docs/mcp/byof (Markdown: https://hyviral.com/docs/mcp/byof.md)
- Claude skill: https://hyviral.com/skill/SKILL.md
- Motion graphics gallery: https://hyviral.com/docs/mcp/graphics (Markdown: https://hyviral.com/docs/mcp/graphics.md)
- Motion graphics agent index: https://hyviral.com/skill/graphics/index.md
- Motion graphics JSON and availability: https://hyviral.com/skill/graphics/catalog.json and https://hyviral.com/skill/graphics/release.json

## Notes for agents

- In a chat app such as Claude or ChatGPT, the person you are helping adds HYVIRAL as a
  connector; an assistant cannot add one from inside the conversation. In Claude: Settings →
  Connectors → Add custom connector, then paste https://api.hyviral.com/mcp. A coding agent such as Claude
  Code can add it itself: `claude mcp add --transport http hyviral https://api.hyviral.com/mcp`.
  Every client: https://hyviral.com/docs/mcp/connect (Markdown: https://hyviral.com/docs/mcp/connect.md)
- This file and the pages it links to are the same information served to everyone.
  There is no separate agent-only content and no cloaking.
- Pricing as JSON: https://hyviral.com/pricing.json