# Heista MCP server

Decode video ads, load brand intelligence, generate ad scripts.

## Links
- Registry page: https://www.getdrio.com/mcp/co-heista-api
- Repository: https://github.com/Heista-co/heista-mcp
- Website: https://www.heista.co

## Install
- Endpoint: https://www.heista.co/api/mcp/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote URL variable: API_KEY (secret)
- Remote header: Authorization (secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://www.heista.co/api/mcp/mcp
- Header: Authorization
- URL variable: API_KEY

## Tools
- decode_ad (Decode Video Ad) - Reverse-engineer any video ad into its structural formula. Returns a beat-by-beat breakdown, hook classification, behavioral psychology, creative format, and performance signals (active days, runtime). Use the result as a structural template for new scripts via generate_adscript. Submit a URL — returns a job_id to poll with get_decode. Supports Facebook Ad Library, TikTok, Instagram Reels, YouTube Shorts, and direct .mp4 URLs. Costs 15 credits for videos ≤60s, 20 credits for 61-120s. Endpoint: https://www.heista.co/api/mcp/mcp
- get_decode (Get Decode Result) - Retrieve a completed decode (full structural breakdown) or check status of a running job. Pass the job_id from decode_ad. If status is processing, wait 15 seconds and call again. Endpoint: https://www.heista.co/api/mcp/mcp
- create_powersource_url (Create PowerSource from URL) - Build a creative intelligence profile of any brand from their website. Optimized for direct-response ad creative, brand voice replication, and audience targeting. Output is structured for injection into ad scripts, not for executive brand strategy. 

What's sourced from where (every section in the response carries a _scope tag):
- BRAND-LEVEL (cached at domain level, identical across products on the same site): brand_voice, brand_story, brand_style (colors), brand_assets (fonts, logo).
- PRODUCT-LEVEL (fresh per URL — varies by which page you scanned): identity, offer, selling_points, ctas.
- SYNTHESIZED (derived from both layers via strategy agents): buyer_profile, tensions, angles, emotional_arcs, narrative.
- SITE-LEVEL pulse signals (homepage hero scan, apply brand-wide not per-PDP): promotions.has_seasonal, has_new_drop, has_announcement.

Feeds directly into generate_adscript and other Heista generation tools — pass the returned brief_id or job_id as powersource_id. Costs 100 credits. Re-scanning the exact same URL within your org returns the cached result for free. A different page on the same domain still costs 100 credits, but the brand layer (voice, story, style, assets) is reused from cache so synthesis is faster. Endpoint: https://www.heista.co/api/mcp/mcp
- get_powersource (Get PowerSource Result) - Retrieve a completed PowerSource (full creative intelligence profile) or check status of a running scan. Pass the job_id from any create_powersource_* call. If status is processing, wait 3-5 seconds and call again. During synthesis, partial intelligence appears progressively — buyer archetype, tensions, selling points. Read each response. Endpoint: https://www.heista.co/api/mcp/mcp
- create_powersource_docs (Create PowerSource from Documents) - Build a complete creative intelligence profile from internal brand documents — creative briefs, brand guidelines, product specs, customer research, competitive analysis. Returns the same shape as create_powersource_url: brand identity, buyer profile, tensions, angles, voice, proof. Use when the truth lives in PDFs and DOCX, not on the website. Pass file_ids from the Files API or document_urls (PDF, DOCX, TXT, MD). Optionally pass context_url for additional live brand context. Costs 100 credits. Endpoint: https://www.heista.co/api/mcp/mcp
- create_powersource_full (Create PowerSource Full (URL + Documents)) - Build the highest-fidelity creative intelligence profile by combining a website URL with internal brand documents. Use when you want public messaging triangulated against internal strategy — the result has stronger conviction on voice, positioning, and proof than either source alone. Returns the same shape as create_powersource_url. Requires both a URL and at least one document (file_id or document_url). Costs 200 credits. For URL-only or docs-only, use the single-mode variants. Endpoint: https://www.heista.co/api/mcp/mcp
- check_balance (Check Balance) - Check Heista API credit balance, this month's usage broken down by operation, and pricing for every paid tool. Returns balance in cents, lifetime spend, month-to-date counts per tool, and a top-up link. Call when the user asks about credits, balance, usage, top-ups, or pricing. Endpoint: https://www.heista.co/api/mcp/mcp
- get_hook_intelligence (Get Hook Intelligence) - Get proven hook patterns from Heista's corpus of decoded winning ads. Returns hook examples, templates, the psychology behind why each one stops the scroll, and runtime performance data. Use to write scroll-stopping openers grounded in what works. Free. Filter by vertical (e.g. BEAUTY_SKINCARE) and hook_type (e.g. CURIOSITY_SPIKE). Endpoint: https://www.heista.co/api/mcp/mcp
- adformula_intelligence (Ad Formula Intelligence) - Get proven ad formula blueprints — structural patterns clustered from 3-10+ winning ads that independently converged on the same beat architecture while Meta kept rewarding them with sustained spend. Each formula carries: source ad count, average active days (runtime proof), confidence score, 6-layer beat blueprint, per-beat visual direction. Formulas are the category-replication source. Use for generate_adscript with source_type="formula". Free. Filter by vertical first, then narrow by creative_format or marketing_angle to match the brand. When picking among results: prioritise (1) avg_active_days as primary proof, (2) marketing_angle alignment with PowerSource buyer tension, (3) source_ad_count for cluster robustness, (4) confidence_score as tiebreaker. Note: formulas are abstracted from source ads — they carry the structure but not exact transcripts. For sentence-level fidelity, use a single decode instead. Endpoint: https://www.heista.co/api/mcp/mcp
- decoder_intelligence (Decoder Intelligence) - Browse individual decoded ads from Heista's corpus of real winning Meta/TikTok creative. Each result returns the full structural breakdown — beat timeline, classification, psychology, and runtime performance — plus an `id` you can pass into generate_adscript with source_type="decode" to write a fresh script on that exact structure. Use when you want a specific ad as a template, not an averaged formula. Free. Filter by vertical, creative_format, marketing_angle, hook_type, or brand name (partial match). Endpoint: https://www.heista.co/api/mcp/mcp
- generate_adscript (Generate Ad Script) - Generate direct-response video ad scripts from a proven structure plus a brand's PowerSource. Output is direct-response video ad copy for paid social (Meta, TikTok, Reels) in the brand's voice, with a hook, beat-by-beat body, and CTA close. Pass source_id (from adformula_intelligence, decoder_intelligence, or decode_ad) plus source_type and a powersource_id (job_id or brief_id from create_powersource_*). script_mode: "blueprint" preserves the source structure exactly; "remix" keeps the psychological architecture but writes original copy. Generate 1-5 variants per call (tensions and selling points auto-rotated across variants). Metered pricing — typically 2-5 credits per script depending on length (~2 credits for a 15s script, ~5 credits for a 60s script). Pre-flight reserves a 17-credit ceiling and refunds the difference once actual usage is measured. Endpoint: https://www.heista.co/api/mcp/mcp

## Resources
- decode-card - MIME type: text/html;profile=mcp-app

## Prompts
Not captured

## Metadata
- Owner: co.heista
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 11, 2026
- Source: https://registry.modelcontextprotocol.io