API Stock

Generate AI video, images and music. Browse models and prices; OAuth and one prepaid balance.

Should I use this

Quality & Safety

A
Description quality
91%
Schema completeness
86%
Naming quality
98%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'get_account' description lacks action verbin get_account

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,199Tokens (tool definitions)
~1.1 KBTypical response size
Moderate attention impact (0.94% of 128k context)

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-http

What it can do

Tool inventory

Tools (8)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded8 tools