Skip to main content
A Coral Agent is a preconfigured AI entity that communicates, coordinates, and carries out tasks within the Coral OS. They follow a shared set of standards for messaging, authentication, and secure collaboration. Each agent has a unique identifier, capability declarations, and the ability to take part in multi-agent sessions managed by the Coral Server.

​
Key Characteristics

  • Autonomy: Agents can make decisions, delegate subtasks to each other, and generate results on behalf of users.
  • MCP Integration: Agents use the Model Context Protocol (MCP) to interact with the Coral Server and other agents.
  • Threaded Coordination: Agents collaborate through communication threads, allowing for structured and traceable interactions.
  • Configurability: Agents can be fine-tuned using options defined in their coral-agent.toml.

​
Agent Types

  • Registry Agents: These are the base agent definitions (templates) available in the Agent Registry.
  • Agent Instances: When a session is created, the server instantiates one or more agents based on the registry definitions. These instances run in isolated processes (e.g., as Docker containers).

​
Getting Started

If you’re building applications, you have several paths to get started with agents:
  1. Use Pre-built Agents: Browse the Coral Marketplace to find agents developed by the community.
  2. Coralize Existing Tools: Use the Coralizer CLI to turn existing MCP servers or tools into Coral agents.
  3. Build from Scratch: Use our templates to build custom agents using frameworks like Python or Node.js.

​
Adding Agents to the Coral OS

To add an agent to your Coral OS environment, you need to:
  1. Define the Agent: Create a coral-agent.toml file (Edition 3).
  2. Package the Agent: Containerize the agent using Docker (recommended) or as a local executable.
  3. Register the Agent: Add the agent definition to your Coral Server’s Registry.
For more detailed instructions, see the guide on Writing Agents.

​
Payments and remote providers status (v1.1.0)

In Coral Server v1.1.0, execution is limited to local providers. Remote providers and on‑chain payments are disabled. You can still prepare agents for marketplace discovery (export settings, identities), but run them locally on your server. See: