ad-creativeadvertisingpay-per-callscript-generationoauth
Heista decodes any video ad into its structural formula, hooks, and psychology, loads a brand's identity from a website or documents, and generates new ad scripts in that brand's voice, billed per call.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Remote HTTPChoose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Decode a competitor's video ad into its structural formula and hooks
Load your brand's voice from your website or internal briefs
Generate new ad scripts in your brand's voice from a decoded formula
Browse proven hook patterns from the decoded ad corpus for free
Key features
Per-call priced video ad decoding ($0.15-$0.20)
Brand voice loading from a URL, documents, or both ($1-$2)
Ad script generation in a specific brand's voice (~$0.02-$0.05/script)
Free reads: hook intelligence, ad-formula intelligence, decoded corpus, balance checks
Failed runs and cached/duplicate results are never charged
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Heista.
Extracted Tool Capabilities
Per-call priced video ad decoding ($0.15-$0.20)
Brand voice loading from a URL, documents, or both ($1-$2)
Ad script generation in a specific brand's voice (~$0.02-$0.05/script)
Free reads: hook intelligence, ad-formula intelligence, decoded corpus, balance checks
Failed runs and cached/duplicate results are never charged
Documentation Overview
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
| Tool | What it does | Cost |
|---|---|---|
decode_ad | Decode any video ad URL into structural formula, hooks, psychology, visual playbook | $0.15 (≤60s) / $0.20 (61–120s) |
get_decode | Poll for decode result | Free |
create_powersource_url | Load a brand from a website URL | $1.00 |
create_powersource_docs | Load a brand from internal documents (PDF, DOCX, briefs) | $1.00 |
create_powersource_full | Load a brand from URL + documents combined | $2.00 |
get_powersource | Poll for brand load result | Free |
generate_adscript | Generate ad scripts from a decoded ad or formula, in any brand's voice | ~$0.02–$0.05 per script |
get_hook_intelligence | Read proven hook patterns from the decoded corpus | Free |
adformula_intelligence | Read clustered ad formulas from decoded winners | Free |
decoder_intelligence | Read decoded ads from the corpus | Free |
check_balance | Check your account balance and monthly usage | Free |
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
Or install via plugin marketplace:
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 pollingmcp:intelligence— free corpus readsmcp: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):
| Pack | Price | Credits | Decode estimate |
|---|---|---|---|
| Starter | $10 | 1,000 | ~100 decodes |
| Builder ⭐ | $50 | 5,000 | ~500 decodes |
| Scale | $100 | 10,000 | ~1,000 decodes |
| Enterprise | $250 | 25,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.
- Sign up: heista.co
- Console: heista.co/api-console
- Top up: heista.co/api-console/billing
- Manage keys: heista.co/api-console/keys
Reference
| Resource | Link |
|---|---|
| Full API & MCP docs | heista.co/docs |
| OpenAPI spec | heista.co/openapi.yaml |
| Tool schemas (this repo) | tools/ |
| Worked examples | examples/ |
| Per-client install | clients/ |
| Registry manifest | server.json |
| OAuth metadata | /.well-known/oauth-protected-resource |
| Claude Code skills | github.com/Heista-co/claude-code-skills |
| Status | heista.co |
| Support | support@heista.co |
License
Docs in this repo are MIT-licensed (see LICENSE). The Heista MCP server itself runs under heista.co/terms.
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
Last commit
4mo ago
Most recent push to the default branch.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Heista
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/heista)HTML Embed
<a href="https://allmcps.com/mcp/heista"><img src="https://allmcps.com/api/badge/heista?style=directory" alt="Heista on AllMCPs" /></a>Technical Specs & Signals
CategoryMultimedia Process
PricingPaid
13/13 checks healthy over the last 46d
36Quality signal: Fair · 36/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools16/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.