Heista
Decode video ads, load brand intelligence, generate ad scripts.
Open source Repository Open in the app JSON README (API)
About
Decode video ads, load brand intelligence, generate ad scripts.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- co.heista
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Forks
- 1
- Open pull requests
- 1
- Last push
- 2026-05-13T01:37:08Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 03:00:51
- Updated
- 2026-08-29 03:00:51
- Origin id
co.heista/api
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](https://www.heista.co/.well-known/oauth-protected-resource) ## 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](https://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/`](./clients/). ## Authentication OAuth 2.1 is the default. First call returns `401 + WWW-Authenticate: Bearer` with [RFC 9728 Protected Resource Metadata](https://www.heista.co/.well-known/oauth-protected-resource). 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](https://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](https://heista.co/api-console/billing). **Spending caps:** set hourly / daily / monthly caps per organization and per key from [heista.co/api-console/limits](https://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](https://heista.co) - Console: [heista.co/api-console](https://heista.co/api-console) - Top up: [heista.co/api-console/billing](https://heista.co/api-console/billing) - Manage keys: [heista.co/api-console/keys](https://heista.co/api-console/keys) ## Reference | Resource | Link | |----------|------| | Full API & MCP docs | [heista.co/docs](https://heista.co/docs) | | OpenAPI spec | [heista.co/openapi.yaml](https://heista.co/openapi.yaml) | | Tool schemas (this repo) | [`tools/`](./tools/) | | Worked examples | [`examples/`](./examples/) | | Per-client install | [`clients/`](./clients/) | | Registry manifest | [`server.json`](./server.json) | | OAuth metadata | [/.well-known/oauth-protected-resource](https://www.heista.co/.well-known/oauth-protected-resource) | | Claude Code skills | [github.com/Heista-co/claude-code-skills](https://github.com/Heista-co/claude-code-skills) | | Status | [heista.co](https://www.heista.co) | | Support | [support@heista.co](mailto:support@heista.co) | ## License Docs in this repo are MIT-licensed (see [LICENSE](./LICENSE)). The Heista MCP server itself runs under [heista.co/terms](https://heista.co/terms).