Heista

{
  "id": "aix_d5a78c5f8c",
  "name": "Heista",
  "operator": "(unclaimed - source: registry-official · publisher: co.heista)",
  "description": "Decode video ads, load brand intelligence, generate ad scripts.",
  "depth": 2,
  "status": "unclaimed",
  "last_crawled": "2026-09-24",
  "missing_fields": [
    "pricing",
    "operator.identity"
  ],
  "skills": [
    "api-integration",
    "citation-check",
    "cloud-ops",
    "inventory-check",
    "market-data",
    "media-catalog",
    "ocr-extraction",
    "order-tracking",
    "pdf-to-json",
    "sentiment-scan",
    "sql-database",
    "web-scrape"
  ],
  "protocols": {
    "mcp": "https://www.heista.co/api/mcp/mcp",
    "a2a": null
  },
  "pricing": null,
  "regions": [
    "global"
  ],
  "languages": [
    "en"
  ],
  "reputation": {
    "tasks_completed": null,
    "dispute_rate": null,
    "p95_latency_ms": 6243,
    "uptime_30d": 1,
    "onchain_volume_30d_usd": null
  },
  "aix_score": 41,
  "verification": {
    "identity": "none",
    "health": "probe/24h",
    "pricing": "unknown",
    "last_check": "2026-09-24T20:01:23.052Z"
  },
  "pricing_model": "unknown",
  "links": [
    {
      "label": "homepage",
      "url": "https://www.heista.co/"
    },
    {
      "label": "repository",
      "url": "https://github.com/Heista-co/heista-mcp"
    }
  ],
  "avatar": "https://github.com/Heista-co.png?size=160",
  "socials": [
    {
      "label": "github",
      "url": "https://github.com/Heista-co"
    }
  ],
  "profile": {
    "mcp_server": "heista",
    "mcp_version": "1.0.0",
    "tool_count": 118,
    "tools": [
      {
        "name": "decode_ad",
        "description": "Decode a specific video ad URL into its full structural formula — beat-by-beat breakdown, hook classification, behavioral psychology stack, creative format, runtime performance signals (active days on Meta Ad Library when available), and per-cut visual data. Takes one video URL plus an optional idempotency_key. Returns a job_id immediately; poll with get_decode every 15s until status is \"completed\" (typically 45-60s end-to-end). \n\nUse this when the user pastes an ad URL, names a specific competitor ad, asks \"decode this\" or \"break down this ad\" or \"what makes this ad work\", or wants sentence-l"
      },
      {
        "name": "get_decode",
        "description": "Retrieve the full decode bundle for a previously-submitted ad, or poll the status of a running decode job. Takes a single job_id (UUID returned by decode_ad). Returns either status=\"processing\" (call again in 15s) or the completed payload — exact transcripts per beat, director's read, per-cut visual data (shot_breakdown), visual psychology, behaviour biases, beat structure, hook classification, and runtime fields (active days on Meta Ad Library when the source supports it). \n\nUse this immediately after decode_ad and every 15 seconds until the job completes. Also use this to re-fetch a decode a"
      },
      {
        "name": "create_powersource_url",
        "description": "Build a complete creative intelligence profile of a brand from a single website URL. Takes a website URL (homepage, PDP, landing page) plus optional idempotency_key, force_refresh, and webhook_url. Returns a job_id immediately; poll with get_powersource every 3-5s (typically 60-90s total). The final payload contains 14 structured sections: identity, offer, selling_points, brand_story, brand_style, brand_assets, brand_voice, buyer_profile, 12 buyer tensions, marketing angles, emotional_arcs, ctas, proof_assets, and strategic narrative. \n\nUse this when the user says \"analyse my brand\", \"load my "
      },
      {
        "name": "get_powersource",
        "description": "Retrieve the full creative intelligence profile for a previously-submitted PowerSource scan, or poll the status of a running scan. Takes a job_id (UUID returned by any create_powersource_* tool) plus an optional include_raw flag (admin-only). Returns either status=\"processing\" with partial progress or the completed bundle: brand identity, offer, 12 selling points, brand voice rules, buyer profile, 12 buyer tensions, angles, emotional arcs, ctas, proof, narrative. \n\nUse this immediately after any create_powersource_* call and every 3-5 seconds until status is \"completed\". During synthesis, part"
      },
      {
        "name": "create_powersource_docs",
        "description": "Build a complete creative intelligence profile from internal brand documents — creative briefs, brand guidelines, product specs, customer research, competitive analysis. Takes any mix of file_ids (from a previous upload), document_urls (public PDF/DOCX/TXT/MD links, up to 10), or documents_inline (base64-encoded files with filename), plus an optional context_url for layering live brand context (colors, fonts, current messaging) and optional idempotency_key. Returns a job_id; poll with get_powersource. Output shape is identical to create_powersource_url: identity, offer, selling points, voice, "
      },
      {
        "name": "create_powersource_full",
        "description": "Build the highest-fidelity creative intelligence profile by combining a brand's public website URL with their internal documents. Takes a required website URL plus at least one document — file_ids from previous upload, public document_urls (PDF/DOCX/TXT/MD, up to 10), or documents_inline (base64-encoded). Optional idempotency_key for safe retry. Returns a job_id; poll with get_powersource. Same response shape as create_powersource_url, but the synthesis cross-checks how the brand presents publicly against what the team actually believes internally, producing stronger conviction on voice, posit"
      },
      {
        "name": "check_balance",
        "description": "Check the calling user's Heista API credit balance, month-to-date usage broken down by operation, lifetime spend, and the current pricing for every paid tool. Takes no inputs. Returns balance in cents, lifetime spend in cents, month-to-date call counts per tool (decode_ad, create_powersource_*, generate_adscript), per-tool unit pricing, and a top-up link the user can follow to add credits. Free, read-only, idempotent. \n\nUse this whenever the user asks about credits, balance, usage, how much they've spent, top-ups, pricing, \"what does this cost\", or \"how many credits do I have\". This is also th"
      },
      {
        "name": "get_hook_intelligence",
        "description": "Browse proven hook patterns from Heista's corpus of decoded winning Meta/TikTok ads. Takes optional filters: vertical (e.g. BEAUTY_SKINCARE, SUPPLEMENTS, APPAREL), hook_type (e.g. CURIOSITY_SPIKE, CONTRADICTION, CALLOUT), and marketing_angle. Returns hook examples (the real opener lines from successful ads), pattern templates, the psychological mechanism behind why each one stops the scroll within the first 1.5 seconds, and runtime performance data (active days on Meta when available). Free, read-only, idempotent — no credits consumed. \n\nUse this when the user asks \"what hooks stop the scroll\""
      },
      {
        "name": "adformula_intelligence",
        "description": "Browse 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. Takes optional filters: vertical, creative_format (e.g. TALKING_HEAD, UGC, FOUNDER_STORY), marketing_angle, algo_intent, hook_type, and limit (1-10, default 5). Each formula returns: source ad count, average active days (runtime proof), confidence score, 6-layer beat blueprint, per-beat visual direction, marketing angle, psychology mission. Free, read-only, idempotent. \n\nUse this when the user "
      },
      {
        "name": "decoder_intelligence",
        "description": "Browse individual decoded ads from Heista's corpus of real winning Meta/TikTok creative. Takes optional filters: vertical, creative_format, marketing_angle, hook_type, algo_intent, brand (partial name match), and limit (1-10, default 5). Each result returns beat timeline, classification, psychology, runtime performance signals (active days on Meta when available), and a decode id you can pass into generate_adscript with source_type=\"decode\" to write a fresh script on that exact structure. Free, read-only, idempotent — no credits consumed. \n\nUse this when the user wants a specific ad as a scrip"
      },
      {
        "name": "generate_adscript",
        "description": "Generate direct-response video ad scripts by fusing a proven structural source (decoded ad or formula) with a brand's PowerSource. Output is feed-native ad copy for paid social (Meta, TikTok, Reels) in the brand's voice — hook, beat-by-beat body, CTA close, plus visual direction per beat. Takes source_id (from adformula_intelligence, decoder_intelligence, or decode_ad), source_type (\"formula\" or \"decode\"), powersource_id (from any create_powersource_*), and tunable params: count (1-5 variants, tensions and selling points auto-rotated across variants), script_mode (\"blueprint\" preserves source "
      },
      {
        "name": "call_creative_worlds",
        "description": "Heista's creative direction engine — same engine the Creative Director specialist runs internally, exposed over MCP. ONE-SHOT: give a brief, get N finished creative outputs. For back-and-forth refinement, or output shapes the `medium` enum below does not cover, use chat_with_creative_worlds instead. \n\nOUTPUT SHAPE switches on the `medium` arg:\n• omitted → N territory cards (default exploration). Each card sits on different psychology / craft / feel / world axis coordinates so the set spans the creative space rather than orbiting one insight. Card has: name, campaign line, 5-8 sentence pitch, o"
      },
      {
        "name": "call_creative_agent_preset",
        "description": "Invoke a Creative Agent (character) preset. Every preset is a purpose-built character the workspace has authored or the Heista catalog has published — copy voice, art direction, strategy, creative direction, etc. ONE-SHOT: give the character a message, get its response back as text. \n\nDiscover callable presets via list_creative_agent_presets. Workspace-authored presets are only callable inside their owning org; official templates (visibility=public_template) are callable from any authenticated org. \n\nINPUTS: agent_id (UUID from list_creative_agent_presets), message (the turn text), optional br"
      },
      {
        "name": "chat_with_creative_worlds",
        "description": "Multi-turn conversation with Heista's creative direction engine — a real chat where the agent decides each turn what to produce based on what you ask for. Use whenever the work needs more than one round, OR when you want an output shape not covered by call_creative_worlds' `medium` enum.\n\nWHAT YOU CAN ASK FOR (any of these, turn 1 or any turn after):\n• Territories — \"give me five directions for X\", \"what angles work here\"\n• A TVC script — \"write a 30-second TVC for Cowboys\"\n• Billboard concepts — \"three billboards under a quiet-authority lens\"\n• A campaign platform — \"build #2 into a full camp"
      },
      {
        "name": "list_brands",
        "description": "List every brand in this workspace. Use this BEFORE creating a PowerSource to avoid creating duplicate brand records (pass the matching brand_id to create_powersource_*), and to discover brands the user can pivot a Heist to. Each row carries the brand_id (persistent identity), name, domain, asset_count, strategy_count, and brand status. \n\nUse this when the user asks \"what brands do I have\", \"show me my brands\", or before any image-led work where you need to know which brand owns assets. Free, read-only. \n\nDistinguish Brand (persistent, brand_id) from PowerSource (a scan, powersource_id). A bra"
      },
      {
        "name": "get_brand",
        "description": "Get a brand's full canonical record — name, domain, voice (tone_of_voice), story, visual identity (logo, primary color, visual assets), and counts. Use to inspect what a brand carries before deciding which Heist context to run, or to read the brand voice directly when writing copy. Free, read-only."
      },
      {
        "name": "list_strategies",
        "description": "List all PowerSource strategies (scans) for a brand. A brand has many strategies — one per scanned URL. Product-page strategies carry product_name and is_product_page=true; use these to label them in conversation or to pick the right one for a product-focused generation. Returns powersource_id (use as the brief/PowerSource id everywhere else), product_name, scanned_at, source_url, is_pinned. Free, read-only. Paginated via cursor."
      },
      {
        "name": "list_projects",
        "description": "List all projects (campaign folders) for a brand. A project groups strategies, documents, client assets, and outputs under one campaign. Returns project_id (pass as project_id to list_strategies / list_brand_documents / list_brand_assets to scope those reads to this project), name, status, start_date, target_date, and per-type counts. Free, read-only."
      },
      {
        "name": "list_brand_assets",
        "description": "List images for a brand. Filter by PowerSource (this scan only, via powersource_id), by on-pack product_name (the vision tagger's read), by type (logo, product, product_cutout, hero, lifestyle, ingredient, packaging, certification, before_after, infographic, screenshot, video, general), or by is_primary_product. Use this BEFORE generating any image-based output so you pick from the brand's real assets, not generic stock. Returns asset_id, signed url, type, detected_product_name, is_primary_product, sources. Free, read-only. Paginated via cursor."
      },
      {
        "name": "add_brand_asset",
        "description": "Upload an image to a brand by URL. The pipeline downloads it, runs the vision tagger (classifies type, detects product name, flags is_primary_product), stores it in the brand-assets bucket, and inserts a brand_assets row. Paid (vision tag credit). If vision tagging fails, the asset is still saved with type=general and can be retried via retag_brand_asset."
      },
      {
        "name": "delete_brand_asset",
        "description": "Delete one brand asset by asset_id. Removes the brand_assets row and (when the asset was uploaded rather than scanned) the storage object. Destructive — confirm with the user before calling. Use list_brand_assets first to find the asset_id."
      },
      {
        "name": "retag_brand_asset",
        "description": "Re-run the vision tagger on one brand asset. Reads the stored object when present (uploaded assets) or the original URL (scan-sourced assets), then updates type, detected_product_name, is_primary_product, description, and the other vision fields. Useful when the original tagger run missed or misclassified an image. Paid (vision tag credit)."
      },
      {
        "name": "reclassify_brand_assets",
        "description": "Batch re-run the vision tagger against every asset in a brand that hasn't been reviewed yet (vision_classified=false). Recovers rows the scan-time tagger dropped because of CDN blocks (Shopify hotlink, Cloudflare bot gates) or transient failures. Skips videos and rows already marked not_asset. Processes up to 24 assets per call — if more remain, the response returns { remaining > 0 } and the caller can invoke again. Paid (batched vision tag credit, typically < $0.01 per invocation)."
      },
      {
        "name": "list_brand_documents",
        "description": "List indexed brand documents for a brand. Each row carries the indexed signals (doc_type, summary, key_topics, classification_confidence, indexing_status) plus mime_type and size_bytes from the underlying file. Filter by doc_type (one of 19 values incl. voice_tone_doc, brand_guidelines, strategy_memo, customer_interview, pitch_deck, general_reference) or by indexing_status (pending, running, indexed, error). Use BEFORE read_brand_document to discover what context exists for a brand without paying the read cost. Free, read-only. Paginated via cursor."
      },
      {
        "name": "read_brand_document",
        "description": "Read one indexed brand document. Returns the indexed metadata (doc_type, summary, key_topics, entities, key_quotes) plus the document body as plain text in content.text — every mime (PDF, DOCX, PPTX, XLSX, markdown, CSV, plain text). No file ids, no attaching anything on a later turn: the text is in this response. When content is null the body could not be extracted — error_code says why, and you should tell the user rather than infer contents from the title. Use AFTER list_brand_documents to pick the right document. Free, read-only."
      }
    ],
    "profiled_at": "2026-09-14T02:01:05.416Z"
  },
  "unreachable": false,
  "payment_method": "auth"
}