Pull model
pull_modelDownload a model onto a chosen local AI provider, with progress streaming or background job support for long-running pulls.
Instructions
HEAVY: Download a model onto ONE provider (multiple GB, can take a long time). Streams download progress via MCP progress notifications when the client sends a progressToken. With background:true, returns a jobId immediately instead; poll pull_status and stop it with pull_cancel (use this when the client has no progress display or a short tool timeout). Without provider, uses the provider that already has the model, else the first live local provider that can pull.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"model": "<model>"
},
"name": "pull_model"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | Yes | Model id/name to pull (e.g. qwen3:8b, hf.co/<repo>:<quant>) | |
| provider | No | Provider instance name. Omit to let the server choose (local providers only, unless LOCAL_AI_ALLOW_HOSTED_FALLBACK is set). | |
| background | No | Return a jobId at once and download in the background (default false). A second call for the same model joins the running job. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | ||
| pull | No |