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 capabilities are currently available only to China site (aliyun.com) accounts.
Append --help to any command for full parameter details, e.g. bl mcp call --help. Command details on this page are verified against bl 2.5.1.
MCP orchestration
See the MCP docs for feature-page usage.
bl mcp list
List MCP servers activated under your Bailian account.
Usage
| 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) |
bl mcp list --name finance
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. |
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. |
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 |
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 |
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 docs for feature-page usage.
bl skill init
Install all bailian-* skills (one-shot bootstrap for new environments). No authentication required.
Usage
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 |
bl skill list
List registry skills and diff against local installs. No authentication required.
Usage
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) |
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 |
bl skill remove --name spark-video
