How do I install Heista?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Heista need an API key?

No required environment variable is listed on this record.

When was Heista last checked?

Last checked 2026-11-07. Decode video ads, load brand intelligence, generate ad scripts.

Heista MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

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

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http co.heista-api https://www.heista.co/api/mcp/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "co.heista-api": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://www.heista.co/api/mcp/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

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):

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.

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	[email protected]

License

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

Heista

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Heista?

Does Heista need an API key?

What transport does Heista use?

When was Heista last checked?

Documentation

Heista MCP

What you can do

Install

Claude Code

Authentication

Pricing

Account

Reference

License