Coala Client

Part of the coala ecosystem. CLI for chat with OpenAI-compatible LLMs (OpenAI, Gemini, Ollama) and MCP (Model Context Protocol) servers. Supports importing CWL toolsets as MCP servers, importing skills, and an optional sandbox to run shell commands.

Config paths

• MCP config and toolsets: ~/.config/coala/mcps/
• mcp_servers.json — server definitions
• / — per-toolset dirs with run_mcp.py and CWL files
• Skills: ~/.config/coala/skills/ (one subfolder per imported source)
• Env: ~/.config/coala/env (optional; key=value for providers and MCP env)

Quick start

1. Init (first time)

coala init — creates ~/.config/coala/mcps/mcp_servers.json and env.

1. Set API key

e.g. export OPENAI_API_KEY=... or export GEMINI_API_KEY=.... Ollama needs no key.

1. Chat

coala or coala chat — interactive chat with MCP tools.

coala ask "question" — single prompt with MCP.

1. Options

-p, --provider (openai|gemini|ollama|custom), -m, --model, --no-mcp, --sandbox.

MCP: CWL toolsets

No API key needed for MCP import, list, or call — only for chat/ask with an LLM.

• Import (creates toolset under ~/.config/coala/mcps// and registers server):

coala mcp-import or alias coala mcp ...

SOURCES: local .cwl files, a .zip, or http(s) URLs to a .cwl or .zip.

Requires the coala package where the MCP server runs (for run_mcp.py).

• List

coala mcp-list — list server names.

coala mcp-list — print each tool’s schema (name, description, inputSchema).

• Call

coala mcp-call . --args ''

Example: coala mcp-call gene-variant.ncbi_datasets_gene --args '{"data": [{"gene": "TP53", "taxon": "human"}]}'

Skills

• Import (into ~/.config/coala/skills/, one subfolder per source):

coala skill

SOURCES: GitHub tree URL (e.g. https://github.com/owner/repo/tree/main/skills), zip URL, or local zip/dir.

• In chat

/skill — list installed skills.

/skill — load skill from ~/.config/coala/skills// (e.g. SKILL.md) into context.

Chat commands

• /help, /exit, /quit, /clear
• /tools — list MCP tools
• /servers — list connected MCP servers
• /skill — list skills; /skill — load a skill
• /model — show model info
• /switch — switch provider

MCP on/off

• All off: coala --no-mcp (or coala ask "..." --no-mcp).
• One server off: remove its entry from ~/.config/coala/mcps/mcp_servers.json.
• On: default when --no-mcp is not used; add or restore servers in mcp_servers.json.

Providers and env

Set provider via -p or env PROVIDER. Set keys and URLs per provider (e.g. OPENAI_API_KEY, GEMINI_API_KEY, OLLAMA_BASE_URL). Optional: put vars in ~/.config/coala/env.

coala config — print current config paths and provider/model info.