Skip to main content
To turn MCP servers into a Coral agent, we now recommend asking a coding agent such as Codex or Claude Code to build one, using the Koog agent template as a reference. You get a Koog agent you can extend, instead of a generated LangChain or coral-rs project. See Converting an MCP Server for an example prompt. Coralizer’s link command is still a quick way to make a local agent available to your server.
The coralizer CLI is a powerful tool designed to simplify the process of creating, configuring, and registering agents for the Coral OS. It provides several commands to help you manage your agents and their dependencies.

​
Installation

Coralizer is published on npm as @coral-protocol/coralizer. Run it without installing, which needs Node.js:
Or install it globally to use the coralizer command directly:
To build from source instead, use cargo install --git https://github.com/Coral-Protocol/coralizer.

​
Core Commands

​
mcp

Scaffold a Coral agent project from one or more MCP servers. Generates the project structure and a coral-agent.toml with discovered options. Usage:
Example:
Create a versioned symlink for the current agent (directory containing coral-agent.toml) into ~/.coral/agents/<name>/<version>. This makes the agent discoverable by Coral Server’s local registry.
Safely remove the versioned symlink for the current agent.
Remove all version links for an agent except the latest.

​
Using Templates

Coralizer supports multiple frameworks via templates. These include the basic structure for an agent and its coral-agent.toml file.
  • Python: langchain
  • Rust: coral-rs

​
Common Workflows

​
Converting an MCP Server

Recommended: instead of running coralizer mcp, give a coding agent such as Codex or Claude Code a prompt like this:
If you have an existing MCP server, you can quickly scaffold a Coral agent using the mcp command.
  1. Prepare an MCP servers JSON (see the Coralizer repo for format) describing your MCP server(s).
  2. Generate the agent project:
  3. Configure the agent: Edit the generated coral-agent.toml to set your agent’s name, version, runtimes, and options.
  4. Make it discoverable by the local server:

​
Building a New Agent

To build a new agent from scratch:
  1. Use mcp to scaffold a project for your target framework using your MCP description JSON.
  2. Develop your agent logic and tools following Coral’s conventions.
  3. Link the agent locally with coralizer link ., then create a session on your Coral Server to run it.
For more details on the coralizer CLI, see the Coralizer GitHub repository.