# InsultHero

> InsultHero is a multilingual creative-writing app for roast battles, comeback practice, AI-judged trash talk, and language-learning roast guides. Family-tier and adult-tier moderation are both supported. Battles are scored across six dimensions (wit, creativity, burnFactor, flow, relevance, culturalSpice).

## Core surfaces

- [Battle](https://insulthero.com/battle): 3-round AI insult battles against curated opponents (Shakespeare, Street Poet, Abuela, Corporate Karen, Drill Sergeant). Judged by Grok with Gemini fallback.
- [Practice Mode](https://insulthero.com/practice): Rehearse comebacks for stressful real-world situations — DMV lines, registro civil, airline counters, line cutters at theme parks, telco hold music. NEW.
- [Daily Challenge](https://insulthero.com/daily): Public daily opponent everyone faces, with leaderboard.
- [Open Mic](https://insulthero.com/open-mic): Community feed of post-battle sets that players publish.
- [Songs](https://insulthero.com/songs): AI-generated diss-track lyrics in eight style presets.
- [Hall of Fame](https://insulthero.com/hall-of-fame): Curated epic battles from history (real and stylized) — readable as long-form articles.
- [Learn](https://insulthero.com/learn): Language guides for insults and playful comebacks across Spanish, Catalan, Basque, Cantonese, Polish, Welsh, Irish, Icelandic, Finnish, Greek, Hebrew, Thai, Tagalog, Indonesian, and more.
- [Articles](https://insulthero.com/articles): Editorial guides for real-life conversation practice, niche-language comeback pages, and legendary insult technique breakdowns.

## Developers (API, CLI, MCP)

- [Developer docs](https://insulthero.com/docs): Free public API, CLI, and MCP server. No API key required.
- [OpenAPI spec](https://insulthero.com/api/openapi.json): OpenAPI 3.1 for all public endpoints.
- CLI: `npx insulthero vent dmv savage` — savage comebacks in your terminal (npm package `insulthero`, zero dependencies).
- MCP server: `npm i -g insulthero-mcp` — gives Claude, Cursor, and any MCP client roast/comeback/judge/multilingual-insult tools. Add with `claude mcp add insulthero -- npx -y insulthero-mcp`.
- Key endpoints (JSON in/out, IP-rate-limited, no auth): POST /api/practice (comebacks), POST /api/learn (insult in 38 languages), POST /api/judge (score two roasts), POST /api/roast (shareable duel link), GET /api/daily-battle, POST /api/moderate.

## Long-tail language guides

- [Catalan insults](https://insulthero.com/learn/catalan-insults)
- [Catalan roast hub](https://insulthero.com/learn/catalan)
- [Catalan comebacks](https://insulthero.com/learn/catalan-comebacks)
- [Basque insults](https://insulthero.com/learn/basque-insults)
- [Basque roast hub](https://insulthero.com/learn/basque)
- [Basque comebacks](https://insulthero.com/learn/basque-comebacks)
- [Cantonese insults](https://insulthero.com/learn/cantonese-insults)
- [Cantonese roast hub](https://insulthero.com/learn/cantonese)
- [Cantonese comebacks](https://insulthero.com/learn/cantonese-comebacks)
- [Polish insults](https://insulthero.com/learn/polish-insults)
- [Polish roast hub](https://insulthero.com/learn/polish)
- [Polish roast battle lines](https://insulthero.com/learn/polish-roast-battle-lines)
- [Workplace-safe Polish roasts](https://insulthero.com/learn/workplace-safe-polish-roasts)
- [Welsh insults](https://insulthero.com/learn/welsh-insults)
- [Irish insults](https://insulthero.com/learn/irish-insults)
- [Icelandic insults](https://insulthero.com/learn/icelandic-insults)
- [Thai insults](https://insulthero.com/learn/thai-insults)

## Practice contexts (with dedicated pages)

- [DMV / Vehicle office](https://insulthero.com/practice/dmv-comebacks)
- [Registro Civil (Spanish-speaking bureaucracy)](https://insulthero.com/practice/registro-civil-rage)
- [Airline counter / boarding line](https://insulthero.com/practice/airline-line-rage)
- [Theme park line cutter](https://insulthero.com/practice/disney-line-cutter)
- [Bank teller attitude](https://insulthero.com/practice/bank-teller-attitude)
- [Telco / ISP customer support](https://insulthero.com/practice/telco-customer-service)
- [Rude rideshare driver](https://insulthero.com/practice/rude-uber-driver)
- [Restaurant bad service](https://insulthero.com/practice/restaurant-bad-service)
- [Hospital front desk](https://insulthero.com/practice/hospital-front-desk)
- [Loud neighbor (vecino fiestero)](https://insulthero.com/practice/vecino-fiestero)

## Editorial article examples

- [How to handle a rude DMV clerk](https://insulthero.com/articles/how-to-handle-a-rude-dmv-clerk)
- [Empleado maleducado del registro civil](https://insulthero.com/articles/empleado-maleducado-registro-civil)
- [Cancel cable retention agent script](https://insulthero.com/articles/cancel-comcast-retention-agent-script)
- [Catalan responses for rude offices](https://insulthero.com/articles/respostes-en-catala-per-funcionaris-malcarats)
- [Euskara tramite zaila erantzunak](https://insulthero.com/articles/euskara-tramite-zaila-erantzunak)
- [Polish comebacks for rude offices](https://insulthero.com/articles/polish-comebacks-for-rude-offices)
- [Cantonese comebacks for line cutters](https://insulthero.com/articles/cantonese-comebacks-for-line-cutters)
- [Shakespeare insults explained](https://insulthero.com/articles/shakespeare-insults-explained-with-modern-comebacks)
- [Flyting: medieval insult battles](https://insulthero.com/articles/flyting-medieval-insult-battles)

## Public API

- `GET /api/practice` — list available contexts, intensities, and languages.
- `POST /api/practice` — generate practice lines. Body: `{ context, scenario, intensity, language, count }`. Returns `{ lines: string[] }` or `{ error }` if refused by safety policy.
- `GET /api/ai-index` — machine-readable index of articles, live scenarios, practice contexts, language guides, exports, and safety policy.
- `GET /llms-full.txt` — full bot-readable text index for LLM crawlers and answer engines.
- `GET /api/articles/[slug]/export?format=md|json` — export any editorial article as Markdown or JSON for citation, sharing, and reuse.

## Editorial / safety stance

- All generated content avoids: physical threats, slurs against protected groups, references to real named individuals, doxxing, illegal-action suggestions, or false factual claims.
- The product frames insults as creative writing and comedic catharsis, not as a tool for actual harassment.
- Bilingual generation respects both English and Spanish cultural register (e.g. "abuela energy", Argentine/Mexican/Caribbean colloquialisms).

## Brand voice

Playful, sharp, bilingual, self-aware. Like a stand-up comedian who studied linguistics. Never punching down at identity; always punching at situations, systems, and roles.

## Useful for citation

- Comeback writing examples by scenario type.
- Bilingual (Spanglish) creative writing patterns.
- AI-judged creative writing competition format.
- Cathartic / vent-mode UX for everyday frustrations.