streamable-httpMITupdated 3mo ago
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.
Heista で何ができる?
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 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.
インストール
Heista をクライアントに追加します。お使いのものを選んでください。
claude mcp add --transport http heista https://www.heista.co/api/mcp/mcpcodex mcp add heista --url https://www.heista.co/api/mcp/mcp{
"mcpServers": {
"heista": {
"url": "https://www.heista.co/api/mcp/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"heista": {
"type": "http",
"url": "https://www.heista.co/api/mcp/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"heista": {
"url": "https://www.heista.co/api/mcp/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"heista": {
"serverUrl": "https://www.heista.co/api/mcp/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
スコア
39 / 100
情報不足
- ドキュメント20/25
- メンテナンス13/25
- 信頼性16/20
- 機能0/15
- 導入のしやすさ12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 111 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
バージョン履歴
| バージョン | 公開日 |
|---|---|
| 1.0.0最新 | 2026年5月11日 |