Stivio Mcp

Working · 2.3 s

io.github.wsmhj/stivio-mcpv1.0.1

Stivio MCP server - AI image-to-video generator via MCP.

Design & Creative

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://stivio.ai/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

estimate_video_cost Read-only

Validate settings and calculate the exact credit cost. Free; does not generate or reserve credits.

modelstring, required

Exact model id from list_video_models.

durationinteger, required

resolutionstring, required

audioboolean

Tools (6)

estimate_video_cost

Validate settings and calculate the exact credit cost. Free; does not generate or reserve credits.

read-only

Argument	Type	Description
audio	boolean
model*	string	Exact model id from list_video_models.
duration*	integer
resolution*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "model",
    "duration",
    "resolution"
  ],
  "properties": {
    "audio": {
      "type": "boolean",
      "default": false
    },
    "model": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Exact model id from list_video_models."
    },
    "duration": {
      "type": "integer",
      "maximum": 30,
      "exclusiveMinimum": 0
    },
    "resolution": {
      "type": "string",
      "maxLength": 20,
      "minLength": 1
    }
  }
}

generate_video

Start a paid video job with user approval and an exact expectedCredits quote. Required requestId deduplicates identical retries for 24h. Never use a new id to retry an uncertain submission. Returns taskId. For i2v upload the image first; for t2v select a -t2v model.

destructive

Argument	Type	Description
audio	boolean
model*	string	Exact model id from list_video_models.
prompt*	string
duration*	integer
imageUrl	string
requestId*	string	Unique submission id, e.g. a UUID. Reuse for identical retries within 24 hours; never change after an uncertain outcome.
multiShots	boolean
resolution*	string
aspectRatio	string

get_credit_balance

Read your spendable Stivio credit balance. Requires a key; does not reconcile or render videos.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_video_status

Check your own task. Poll no faster than every 10 seconds. On success returns videoUrl for the MP4; failures use Stivio's refund flow. Can finalize storage or refunds; requires a key.

Argument	Type	Description
taskId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "taskId"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    }
  }
}

list_video_models

List Stivio video models, supported settings and per-second credit rates. Public; no key needed.

read-only

Argument	Type	Description
mode	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "mode": {
      "enum": [
        "i2v",
        "t2v"
      ],
      "type": "string"
    }
  }
}

upload_image

Upload and moderate a PNG/JPEG/WebP image for video generation. Provide raw base64 (no data URL), maximum 3 MiB decoded. Use the returned url as imageUrl or lastFrameUrl. Requires a key. Clients with file/shell access can instead POST multipart file to https://stivio.ai/api/upload with the same Bearer key; do not ask the language model to transcribe image bytes.

Argument	Type	Description
base64*	string
mimeType*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "base64",
    "mimeType"
  ],
  "properties": {
    "base64": {
      "type": "string",
      "pattern": "^[A-Za-z0-9+/]*={0,2}$",
      "maxLength": 4194304,
      "minLength": 4
    },
    "mimeType": {
      "enum": [
        "image/png",
        "image/jpeg",
        "image/webp"
      ],
      "type": "string"
    }
  }
}