API Stock
Generate AI video, images and music. Browse models and prices; OAuth and one prepaid balance.
Should I use this
Quality & Safety
Findings (1)
- LOWin get_account
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"api-stock": {
"url": "https://api.api-stock.com/mcp"
}
}
}Remote endpoints
https://api.api-stock.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (8)
🟢list_models(type, query)
List the video, image and music models available, with the starting price of each. Call this first to pick a model.
Input Schema
{
"type": "object",
"properties": {
"type": {
"description": "Only models that produce this kind of media.",
"type": "string",
"enum": [
"video",
"image",
"music"
]
},
"query": {
"description": "Case-insensitive match on the model id, name or vendor.",
"type": "string",
"maxLength": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_model(model)
The full parameter list, price table and an example request for one model. Call this before create_generation: parameters differ between models.
Input Schema
{
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "Model id from list_models."
}
},
"required": [
"model"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢estimate_cost(model, input)
The exact amount create_generation would charge for this request. Nothing is created or charged.
Input Schema
{
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "Model id from list_models, for example `veo3.1-fast`."
},
"input": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Model parameters, exactly as get_model lists them (camelCase). Media inputs are public URLs."
}
},
"required": [
"model",
"input"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡create_generation(model, input, webhook, idempotencyKey, maxCostUsd)
Start a generation. Charges the user's balance and returns a taskId at once; the result arrives later — poll get_task. A failed generation is refunded.
Input Schema
{
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "Model id from list_models, for example `veo3.1-fast`."
},
"input": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Model parameters, exactly as get_model lists them (camelCase). Media inputs are public URLs."
},
"webhook": {
"description": "HTTPS URL to call when the generation completes.",
"type": "string",
"format": "uri"
},
"idempotencyKey": {
"description": "Repeat a call with the same key and the same request to get the same task instead of a second charge.",
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]{1,128}$"
},
"maxCostUsd": {
"description": "Refuse the request if it would cost more than this.",
"type": "number",
"minimum": 0
}
},
"required": [
"model",
"input"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡create_upload_url(contentLength, contentType)
Get a signed URL to PUT one local image, video or audio file (up to 25 MiB). Upload is free, but requires a positive balance. After PUT succeeds, use publicUrl as a generation input. The upload URL expires in 10 minutes; at most 20 URLs per minute per user.
Input Schema
{
"type": "object",
"properties": {
"contentLength": {
"type": "integer",
"minimum": 1,
"maximum": 26214400,
"description": "Exact file size in bytes. The upload must have this size."
},
"contentType": {
"type": "string",
"enum": [
"image/png",
"image/jpeg",
"image/webp",
"video/mp4",
"video/quicktime",
"video/webm",
"audio/mpeg",
"audio/wav",
"audio/mp4"
],
"description": "MIME type of the input file."
}
},
"required": [
"contentLength",
"contentType"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_task(taskId, waitSeconds)
Status of a generation and, once finished, the URLs of its files. Pass waitSeconds to wait for it to finish instead of polling in a loop.
Input Schema
{
"type": "object",
"properties": {
"taskId": {
"type": "string",
"description": "The taskId create_generation returned."
},
"waitSeconds": {
"description": "Wait up to this many seconds for the task to finish (max 30).",
"type": "integer",
"minimum": 0,
"maximum": 30
}
},
"required": [
"taskId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_generations(page, pageSize, type, status)
The user's generations, newest first.
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 20
},
"type": {
"type": "string",
"enum": [
"video",
"image",
"music"
]
},
"status": {
"type": "string",
"enum": [
"not_started",
"processing",
"finished",
"failed",
"expired"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_account
The prepaid balance generations are charged from, and where to top it up.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence