# AnimStats Agent Skill

> Use AnimStats when the user wants shareable animated GIFs/MP4s from stats, milestones, or public 𝕏 profile signals — or when an agent should generate viral X tool previews.

## When to use

- Preview Twitter/X aura, account age, or playful account worth for a handle
- List AnimStats free viral tools and send the user a generate URL
- Render a branded Studio template to MP4 (requires AnimStats API key)

## MCP server

- **URL:** `https://www.animstats.com/api/mcp`
- **Docs:** https://www.animstats.com/agents
- **Auth:** None for `list_free_tools` and `free_tool_preview`. Bearer API key for `render_template`.

## Tools

### list_free_tools
No input. Returns free tool ids, titles, and `page_url`s.

### free_tool_preview
Input: `tool_id`, `username` (handle without @).

Live summaries for:
- `twitter-age`
- `twitter-aura`
- `how-much-your-twitter-is-worth`

Other tool ids return `page_url` with `?u=` prefilled for browser generate.

### list_templates / get_template
Catalog of API-renderable Studio templates.

### render_template
Requires `Authorization: Bearer <api-key>` (API plan). Sync MP4 render; may take up to ~90s.

## Suggested prompts

1. “List AnimStats free tools.”
2. “Preview twitter-aura for @example.”
3. “Give me the page URL to generate a worth GIF for @example.”
4. “List AnimStats templates, then render celebration-template as 9:16.”

## Product facts

- Site: https://www.animstats.com
- Plans: Animer / Growth / Influencer / API — see https://www.animstats.com/pricing
- Humans use Studio in-browser; agents use MCP/API for the same render surface.