ollama-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OLLAMA_HOST | No | Alternative environment variable for Ollama endpoint URL. | |
| OLLAMA_MCP_CONFIG | No | Path to the user config file. Overrides the default configuration file location. | ~/.ollama-mcp/config.json |
| OLLAMA_MCP_BASE_URL | No | Ollama endpoint URL. | http://127.0.0.1:11434 |
| OLLAMA_MCP_STATE_DIR | No | Directory where prompts, transcripts, and results are stored. | ~/.ollama-mcp/jobs |
| OLLAMA_MCP_CLAUDE_BIN | No | Path to the Claude Code CLI. | claude |
| OLLAMA_MCP_DEFAULT_MODEL | No | Model used when a call omits one. Defaults to first allowed cloud model. | |
| OLLAMA_MCP_ALLOWED_MODELS | No | Comma-separated list of models delegation may use. Default is all models. | |
| OLLAMA_MCP_JOB_TIMEOUT_MS | No | Hard kill timeout in milliseconds for one turn. | 1800000 |
| OLLAMA_MCP_DELEGATION_MODE | No | How eagerly delegation is used: off, ondemand, or auto. | ondemand |
| OLLAMA_MCP_PERMISSION_MODE | No | Default permission mode for delegates: auto, acceptEdits, bypassPermissions, manual, dontAsk, or plan. | auto |
| OLLAMA_MCP_MAX_INLINE_CHARS | No | Maximum characters returned inline. Output above this is truncated; full text is available on disk. | 60000 |
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_modelsA | List the Ollama models available for delegation, the current delegation mode and allowed-model policy, and the environment variables a delegated session receives. Use this to pick a These settings are user-controlled. There is no tool to change them: if the user wants a different delegation mode or model policy, tell them to run |
| delegate_startA | Start a headless Claude Code session backed by an Ollama model and return immediately with a job_id. It runs in its own process with its own environment, so your Anthropic credentials and model settings are untouched. Poll with delegate_status, collect with delegate_result, and continue the conversation with delegate_followup. Pass WHEN TO USE — ON EXPLICIT REQUEST ONLY. Delegation mode is "ondemand". Call this only when the user actually asks for it: "delegate this", "use ollama", "ask qwen", "run this on a local model", or when they name an Ollama model. If the user has not asked for delegation, do the work yourself and do not offer this tool unprompted. This policy is set by the user and is not yours to change. If it is getting in the way, say so and let the user run |
| delegate_followupA | Send another message to an existing delegated session, resuming its full conversation history. Identify it by job_id (any turn) or session_id. Returns a new job_id for this turn while keeping the same session_id, so you can go back and forth with the Ollama model. Only continue conversations the user asked you to start. |
| delegate_statusA | Report whether a delegated job is still running, plus a tail of what the Ollama session has been doing — its actual tool calls and partial text. Optionally block until it finishes. Use the tool-call trace to check that a delegate really did the work it claims. |
| delegate_resultA | Return the final text produced by a delegated Ollama session, plus its session_id for follow-ups. Blocks until the job finishes if you pass wait_seconds. |
| delegate_cancelA | Terminate a running delegated Ollama session and everything it started. |
| delegate_listC | Show delegated jobs from this server's lifetime, newest first, grouped by conversation. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |