Heista

co.heistaPublished by heista.coOfficial publisherv1.0.0Updated Nov 2, 2026

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

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & CommerceMedia & Design

Overview

AI-generated overview

Heista decodes video ads, loads brand profiles, and generates ad scripts from inside MCP-compatible clients, billed per call.

What you can do
  • Decode a video ad URL into its formula, hooks, psychology and visual playbook, then poll for the result
  • Load a brand profile from a website URL, internal documents, or both, and poll for completion
  • Generate ad scripts in a chosen brand's voice from a decoded ad or formula
  • Read free corpus intelligence: proven hook patterns, clustered ad formulas, and decoded ads
  • Check account balance and monthly usage
When to use it
Useful for marketers, creative strategists and agencies who want an assistant to break down competitors' video ads, build a reusable brand profile, and draft scripts in that brand's voice without leaving the chat client.
Requirements
Remote Streamable HTTP endpoint; no local package. A Heista account is required for paid tools. Authentication is OAuth 2.1 by default, or an API key passed as an Authorization Bearer header for headless use. Paid calls draw on prepaid credits.
Before you install
Paid tools spend real money per call (decodes, brand loads, script generation), reserved up front and refunded for excess; set spending caps. An API key is a secret shown once and should be scoped and capped. Brand loads send website content or uploaded internal documents to Heista's servers.

Installation

In SourceWeft

  1. Open Heista in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/co.heista%2Fapi/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "heista": {
      "type": "http",
      "url": "https://www.heista.co/api/mcp/mcp"
    }
  }
}

README

Heista MCP

The Heista MCP server. Decode any video ad. Load any brand. Generate scripts. From inside Claude, ChatGPT, Cursor, VS Code, and any other MCP-compatible client.

Endpoint: https://www.heista.co/api/mcp/mcp Transport: Streamable HTTP (MCP protocol 2025-03-26) Auth: OAuth 2.1 (preferred) or API key (Authorization: Bearer hst_live_*) Status: Live

What you can do

ToolWhat it doesCost
decode_adDecode any video ad URL into structural formula, hooks, psychology, visual playbook$0.15 (≤60s) / $0.20 (61–120s)
get_decodePoll for decode resultFree
create_powersource_urlLoad a brand from a website URL$1.00
create_powersource_docsLoad a brand from internal documents (PDF, DOCX, briefs)$1.00
create_powersource_fullLoad a brand from URL + documents combined$2.00
get_powersourcePoll for brand load resultFree
generate_adscriptGenerate ad scripts from a decoded ad or formula, in any brand's voice~$0.02–$0.05 per script
get_hook_intelligenceRead proven hook patterns from the decoded corpusFree
adformula_intelligenceRead clustered ad formulas from decoded winnersFree
decoder_intelligenceRead decoded ads from the corpusFree
check_balanceCheck your account balance and monthly usageFree

Same-domain re-runs of create_powersource_* by the same org are free. Decodes already in your library are free. Failed runs cost nothing.

Full reference, schemas, examples: heista.co/docs.

Install

Claude Code

bash
claude mcp add heista https://www.heista.co/api/mcp/mcp

Or install via plugin marketplace:

bash
/plugin marketplace add Heista-co/claude-code-skills/plugin install heista-decode@heista-skills

Per-client snippets: clients/.

Authentication

OAuth 2.1 is the default. First call returns 401 + WWW-Authenticate: Bearer with RFC 9728 Protected Resource Metadata. MCP clients follow the chain automatically and prompt the user to sign in.

For headless / server-to-server use, generate an API key at heista.co/api-console/keys and pass it as Authorization: Bearer hst_live_.... Keys are SHA-256 hashed at rest, shown in plaintext once, scoped per key, and capped per day/month.

Scopes:

  • mcp:account — balance, decode/powersource polling
  • mcp:intelligence — free corpus reads
  • mcp:tools — paid generation (decode, powersource, adscript)

mcp:tools is elevated via WWW-Authenticate scope=mcp:tools on first paid call.

Pricing

Pay as you go, no subscription required. All paid calls reserve the maximum cost up front and refund any excess after.

Credit packs (1 credit = 1¢ USD):

PackPriceCreditsDecode estimate
Starter$101,000~100 decodes
Builder ⭐$505,000~500 decodes
Scale$10010,000~1,000 decodes
Enterprise$25025,000~2,500 decodes

Buy at heista.co/api-console/billing.

Spending caps: set hourly / daily / monthly caps per organization and per key from heista.co/api-console/limits. The server enforces the cap before any compute runs.

Account

A Heista account is required for paid tools. The free intelligence reads work after OAuth sign-in.

Reference

ResourceLink
Full API & MCP docsheista.co/docs
OpenAPI specheista.co/openapi.yaml
Tool schemas (this repo)tools/
Worked examplesexamples/
Per-client installclients/
Registry manifestserver.json
OAuth metadata/.well-known/oauth-protected-resource
Claude Code skillsgithub.com/Heista-co/claude-code-skills
Statusheista.co
Support[email protected]

License

Docs in this repo are MIT-licensed (see LICENSE). The Heista MCP server itself runs under heista.co/terms.

Source: README.md at commit b9bf0cc

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts