{
  "markdown": "# Heista MCP\n\nThe 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.\n\n**Endpoint:** `https://www.heista.co/api/mcp/mcp`\n**Transport:** Streamable HTTP (MCP protocol 2025-03-26)\n**Auth:** OAuth 2.1 (preferred) or API key (`Authorization: Bearer hst_live_*`)\n**Status:** [Live](https://www.heista.co/.well-known/oauth-protected-resource)\n\n## What you can do\n\n| Tool | What it does | Cost |\n|------|--------------|------|\n| `decode_ad` | Decode any video ad URL into structural formula, hooks, psychology, visual playbook | $0.15 (≤60s) / $0.20 (61–120s) |\n| `get_decode` | Poll for decode result | Free |\n| `create_powersource_url` | Load a brand from a website URL | $1.00 |\n| `create_powersource_docs` | Load a brand from internal documents (PDF, DOCX, briefs) | $1.00 |\n| `create_powersource_full` | Load a brand from URL + documents combined | $2.00 |\n| `get_powersource` | Poll for brand load result | Free |\n| `generate_adscript` | Generate ad scripts from a decoded ad or formula, in any brand's voice | ~$0.02–$0.05 per script |\n| `get_hook_intelligence` | Read proven hook patterns from the decoded corpus | Free |\n| `adformula_intelligence` | Read clustered ad formulas from decoded winners | Free |\n| `decoder_intelligence` | Read decoded ads from the corpus | Free |\n| `check_balance` | Check your account balance and monthly usage | Free |\n\nSame-domain re-runs of `create_powersource_*` by the same org are free. Decodes already in your library are free. Failed runs cost nothing.\n\nFull reference, schemas, examples: [heista.co/docs](https://heista.co/docs).\n\n## Install\n\n### Claude Code\n```bash\nclaude mcp add heista https://www.heista.co/api/mcp/mcp\n```\nOr install via plugin marketplace:\n```bash\n/plugin marketplace add Heista-co/claude-code-skills\n/plugin install heista-decode@heista-skills\n```\n\nPer-client snippets: [`clients/`](./clients/).\n\n## Authentication\n\nOAuth 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.\n\nFor 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.\n\nScopes:\n- `mcp:account` — balance, decode/powersource polling\n- `mcp:intelligence` — free corpus reads\n- `mcp:tools` — paid generation (decode, powersource, adscript)\n\n`mcp:tools` is elevated via `WWW-Authenticate scope=mcp:tools` on first paid call.\n\n## Pricing\n\nPay as you go, no subscription required. All paid calls reserve the maximum cost up front and refund any excess after.\n\n**Credit packs** (1 credit = 1¢ USD):\n\n| Pack | Price | Credits | Decode estimate |\n|------|-------|---------|-----------------|\n| Starter | $10 | 1,000 | ~100 decodes |\n| Builder ⭐ | $50 | 5,000 | ~500 decodes |\n| Scale | $100 | 10,000 | ~1,000 decodes |\n| Enterprise | $250 | 25,000 | ~2,500 decodes |\n\nBuy at [heista.co/api-console/billing](https://heista.co/api-console/billing).\n\n**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.\n\n## Account\n\nA Heista account is required for paid tools. The free intelligence reads work after OAuth sign-in.\n\n- Sign up: [heista.co](https://heista.co)\n- Console: [heista.co/api-console](https://heista.co/api-console)\n- Top up: [heista.co/api-console/billing](https://heista.co/api-console/billing)\n- Manage keys: [heista.co/api-console/keys](https://heista.co/api-console/keys)\n\n## Reference\n\n| Resource | Link |\n|----------|------|\n| Full API & MCP docs | [heista.co/docs](https://heista.co/docs) |\n| OpenAPI spec | [heista.co/openapi.yaml](https://heista.co/openapi.yaml) |\n| Tool schemas (this repo) | [`tools/`](./tools/) |\n| Worked examples | [`examples/`](./examples/) |\n| Per-client install | [`clients/`](./clients/) |\n| Registry manifest | [`server.json`](./server.json) |\n| OAuth metadata | [/.well-known/oauth-protected-resource](https://www.heista.co/.well-known/oauth-protected-resource) |\n| Claude Code skills | [github.com/Heista-co/claude-code-skills](https://github.com/Heista-co/claude-code-skills) |\n| Status | [heista.co](https://www.heista.co) |\n| Support | [support@heista.co](mailto:support@heista.co) |\n\n## License\n\nDocs in this repo are MIT-licensed (see [LICENSE](./LICENSE)). The Heista MCP server itself runs under [heista.co/terms](https://heista.co/terms).\n",
  "bytes": 4793,
  "sha": "674b74bd12564a2e40a07cdb3bd19fb1d9adb4fdd2cb94a4b75b4a1fc40bcc5d",
  "repo_slug": "heista-co/heista-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_co_heista_api_5771f3e2/readme"
}