ollama-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OLLAMA_HOST | No | Daemon address | http://localhost:11434 |
| DEBUG_OLLAMA_MCP | No | 1 for verbose stderr | |
| OLLAMA_MCP_CONFIG | No | Explicit config path | |
| OLLAMA_MCP_DETAIL | No | Default response verbosity | concise |
| OLLAMA_MCP_RANKING | No | Tie-break policy among capable models | resident-then-smallest |
| OLLAMA_MCP_FILE_ROOTS | No | Colon-separated readable roots | cwd |
| OLLAMA_MCP_KEEP_ALIVE | No | Longer than Ollama's default; batch-friendly | 10m |
| OLLAMA_MCP_TIMEOUT_MS | No | Total request timeout | 600000 |
| OLLAMA_MCP_ROLE_<NAME> | No | Comma-separated chain; defines new roles | |
| OLLAMA_MCP_ALIAS_<NAME> | No | Shorthand → real model name | |
| OLLAMA_MCP_DEFAULT_ROLE | No | Role used when model is omitted | general |
| OLLAMA_MCP_DEFAULT_THINK | No | See the trap above | false |
| OLLAMA_MCP_REGISTRY_TTL_MS | No | Model-list cache TTL | 60000 |
| OLLAMA_MCP_MAX_OUTPUT_CHARS | No | Output cap before truncation | 100000 |
| OLLAMA_MCP_BATCH_CONCURRENCY | No | Within-group concurrency; 1 is VRAM-safe | 1 |
| OLLAMA_MCP_CONNECT_TIMEOUT_MS | No | Separate and short, so a down daemon fails fast | 3000 |
| OLLAMA_MCP_DEFAULT_TEMPERATURE | No | Determinism by default | 0 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ollama_dispatchA | Run one generation on a local Ollama model and return its output. Use for summarization, extraction, reformatting and other mechanical work you do not want to spend your own context on. Supports structured output ( |
| ollama_dispatch_batchA | Run many generations in one call. Items are grouped by resolved model and the groups run sequentially, so a cold model load is paid at most once per model instead of thrashing VRAM. Results are returned in input order regardless of execution order, and one failing item never voids the run. Prefer this over many separate ollama_dispatch calls: it is faster and costs you far less context. |
| ollama_modelsA | List the models installed on the Ollama host with their capabilities, context window, size and whether they are currently loaded. Filter with |
| ollama_lifecycleA | Manage model residency. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool targets a distinct function: single generation, batch generation, model inventory, and model residency management. The batch and single dispatch tools could be confused, but the descriptions clearly differentiate them.
All names share an 'ollama_' prefix but the suffix mixes verbs (dispatch, dispatch_batch) with nouns (models, lifecycle), lacking a consistent verb_noun pattern. The naming is still readable and intuitive.
Four tools is an appropriate size for an Ollama integration, covering generation and model management without unnecessary bloat.
The server covers single and batch generation plus model listing and lifecycle management, which are the core operations. Missing operations like model pull/delete are handled outside the MCP, so the surface is reasonably complete.