Search DevTools

Jump to any tool or page

Heista

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

Heista-co0 stars1 forksDeveloper Tools
View source

Install

mcp_config.json

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

Documentation

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

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

Or install via plugin marketplace:

/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
Supportsupport@heista.co

License

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

Sourced from the repository README.

More in Developer Tools