MCP & Skill

Bailian CLI command reference for orchestrating MCP services and managing the skill registry.

Orchestrate MCP services and manage the skill registry from the terminal: list active MCP servers, inspect and invoke tools, register Bailian MCP servers into Agent native configurations, and install, update, and remove skills.

MCP orchestration

See the MCP servers for feature-page usage.

bl mcp list

List MCP servers activated under your Bailian account.

Usage

bl mcp list [flags]

Parameter	Type	Required	Description
--name <text>	string	no	Filter by server name (substring match)
--type <type>	string	no	Server type: OFFICIAL | PRIVATE (default: OFFICIAL)
--page <n>	number	no	Page number (default: 1)
--page-size <n>	number	no	Results per page (default: 30)

Example: List MCP servers with name containing 'finance'

bl mcp list --name finance

bl mcp tools

List tools exposed by an MCP server (tools/list). Requires API Key authentication.

Usage

bl mcp tools --server <code> [--url <url>]

Parameter	Type	Required	Description
--server <code>	string	yes	Server code from mcp list (e.g. market-cmapi00073529)
--url <url>	string	no	Override the MCP endpoint URL (non-Bailian). Tries Streamable HTTP first, then classic SSE on the same URL.

Example: List tools from MCP server market-cmapi00073529

bl mcp tools --server market-cmapi00073529

bl mcp call

Call a tool on an MCP server (tools/call). Requires API Key authentication.

Usage

bl mcp call --target <server.tool> [--arg k=v ...] [--json '{...}'] [--url <url>]

Parameter	Type	Required	Description
--target <server.tool>	string	yes	Server code and tool name joined by a dot, e.g. market-cmapi00073529.SmartStockSelection
--arg <kv>	array	no	Tool argument (repeatable). Values parsed as JSON if possible, else string.
--json <obj>	string	no	Full arguments object as JSON; merged with --arg (arg wins).
--query <text>	string	no	Shortcut for --arg query=<text> (mirrors many DashScope MCP tools).
--url <url>	string	no	Override the MCP endpoint URL (non-Bailian). Tries Streamable HTTP first, then classic SSE on the same URL.

Example: Call SmartStockSelection tool with query about consumer stocks

bl mcp call --target market-cmapi00073529.SmartStockSelection --query "Screen consumer stocks with ROE > 15%"

Native Agent registration

bl mcp connect

Register a Bailian MCP server in an Agent's native configuration. Requires API Key authentication.

Usage

bl mcp connect --server <code> --transport <streamable-http|sse> --agent <agent|all>

Parameter	Type	Required	Description
--server <code>	string	yes	Bailian MCP Server Code, such as TextGenerateImage
--transport <transport>	string	yes	MCP transport exposed by the server: streamable-http or sse
--agent <agent>	string	yes	Target Agent: codex, claude-code, cursor, qoder, qoderwork, qwenwork, qwen-code, gemini, opencode, openclaw, deepseek-harness, zcode, workbuddy, pi, or all

Example: Connect TextGenerateImage server to cursor agent via streamable-http

bl mcp connect --server TextGenerateImage --transport streamable-http --agent cursor

• This release registers the official China-site MCP endpoint; the model API --base-url does not change the MCP endpoint.
• The resolved API key is written to the selected Agent's private local configuration. Existing unmanaged entries are never overwritten.
• qoder, qoderwork, and qwenwork are independent products. qwenwork is QwenWork (千问办公); qoderwork is Qoder Work.
• workbuddy covers CodeBuddy / WorkBuddy. deepseek-harness is DeepSeek Harness and only accepts streamable-http.

bl mcp disconnect

Remove an unchanged MCP registration previously managed by bailian-cli. No authentication required.

Usage

bl mcp disconnect --server <code> --agent <agent|all>

Parameter	Type	Required	Description
--server <code>	string	yes	Bailian MCP Server Code used during connect
--agent <agent>	string	yes	Target Agent: codex, claude-code, cursor, qoder, qoderwork, qwenwork, qwen-code, gemini, opencode, openclaw, deepseek-harness, zcode, workbuddy, pi, or all

Example: Disconnect TextGenerateImage server from cursor agent

bl mcp disconnect --server TextGenerateImage --agent cursor

• A registration changed after connect is left untouched and reported as a conflict.

Skill management

See the Skill for feature-page usage.

bl skill init

Install all bailian-* skills (one-shot bootstrap for new environments). No authentication required.

Usage

bl skill init

This command only supports global flags.

• Fetches the registry index and installs every skill whose name starts with bailian-.
• Equivalent to: bl skill add --all (filtered to bailian-* skills).

bl skill add

Install skills from the Bailian skill registry into local agents. No authentication required.

Usage

bl skill add --all | --name <name,...>

Parameter	Type	Required	Description
--all	switch	no	Install all skills from the registry
--name <name,...>	string	no	Comma-separated skill names to install

Example: Install all skills from the Bailian skill registry

bl skill add --all

bl skill list

List registry skills and diff against local installs. No authentication required.

Usage

bl skill list

This command only supports global flags.

Example: Show registry skills and local install differences in JSON output

bl skill list --output json

• STATUS: installed | outdated | not-installed | missing (lock has it, dir deleted) | untracked (dir exists, not managed)

bl skill update

Update installed skills to the latest registry versions. No authentication required.

Usage

bl skill update [--all] [--name <name,...>]

Parameter	Type	Required	Description
--all	switch	no	Update all installed skills (default when neither --all nor --name is given)
--name <name,...>	string	no	Comma-separated skill names to update (must be already installed)

Example: Update all installed skills to latest registry versions

bl skill update --all

bl skill remove

Remove locally installed skills (registry is untouched). No authentication required.

Usage

bl skill remove --name <all|name,...>

Parameter	Type	Required	Description
--name <all|name,...>	string	yes	Skills to remove: all or comma-separated skill names

Example: Remove spark-video skill from local installation

bl skill remove --name spark-video