Skip to content
CrawlForge MCP
AI Tool1 credit

list_ollama_models

A discovery helper that lists models available on a local Ollama instance. Use it to find out which models you can pass to extract_with_llm for private, on-device LLM extraction. 1 credit per call.

Use Cases

Discover Available Models

List every model pulled into your local Ollama instance before kicking off extraction jobs.

Verify Ollama Setup

Quickly confirm that your Ollama server is reachable and serving the models you expect.

Pair with extract_with_llm

Programmatically pick a model name from this list and pass it straight to extract_with_llm.

Endpoint

POST/api/v1/tools/list_ollama_models
Auth Required
1 req/s on Free plan
1 credit

Parameters

Request Examples

cURL

terminalBash
curl -X POST https://crawlforge.dev/api/v1/tools/list_ollama_models \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

TypeScript

listOllamaModels.tsTypescript
// npm install crawlforge-sdk
import { CrawlForge } from 'crawlforge-sdk';

const client = new CrawlForge({ apiKey: process.env.CRAWLFORGE_API_KEY });

const result = await client.listOllamaModels({});

// result.data is untyped in crawlforge-sdk 0.1 — its shape is the Response Example below.
const { models } = result.data as { models: { name: string; size: number }[] };
for (const model of models) {
  console.log(model.name, model.size);
}

Python

list_ollama_models.pyPython
# pip install crawlforge
from crawlforge import CrawlForge

client = CrawlForge()  # reads CRAWLFORGE_API_KEY

result = client.list_ollama_models()

# result.data is a plain dict — its shape is the Response Example below.
for model in result.data['models']:
    print(model['name'], model['size'])

Response Example

200 OK0.2s
{
  "success": true,
  "data": {
    "base_url": "http://localhost:11434",
    "count": 3,
    "models": [
      {
        "name": "llama3.1:8b",
        "size": 4700000000,
        "modified_at": "2026-04-20T10:00:00Z",
        "digest": "sha256:abc123..."
      },
      {
        "name": "qwen2.5:7b",
        "size": 4400000000,
        "modified_at": "2026-04-15T08:30:00Z",
        "digest": "sha256:def456..."
      },
      {
        "name": "mistral:7b",
        "size": 4100000000,
        "modified_at": "2026-03-30T12:15:00Z",
        "digest": "sha256:123456..."
      }
    ]
  },
  "credits_used": 1,
  "credits_remaining": 999,
  "processing_time": 215
}
Field Descriptions
data.base_urlOllama instance that was queried
data.countNumber of models returned
data.modelsArray of installed models with name, size (bytes), modified_at, and digest
credits_used1 credit deducted per call

Credit Cost

1 credit
1 credit per call
1 credit per call. A low-cost discovery helper.

Tip: Cache the response client-side if you call this on every extraction — the model list rarely changes between requests.

Related Tools

extract_with_llm
LLM-powered extraction — pass a model name discovered here