Run Coral Server
This guide walks you through setting up and running the Coral Server. the infrastructure layer for enabling agent-to-agent communication using Coral’s Model Context Protocol (MCP). The Coral Server allows agents to register, send and receive structured messages, and collaborate within thread-based conversations.
Overview
The Coral Server is an implementation of the Coral Protocol. It provides core tools that let agents:
- Register themselves
- Create and manage threads
- Send and receive messages
- Mention and discover other agents
This system is still in early development. While the current version runs in local mode only, remote-mode support is in progress to support distributed agent communication across servers.
Requirements
- JDK 17+
- Git
- Gradle (optional → included in wrapper)
- IntelliJ IDEA (recommended for development)
Clone the Repository
Run the Server (Local Mode)
Run Modes
-stdio: Runs using standard input/output-sse-server: Runs SSE server with plain configuration-sse-server-ktor: SSE server using Ktor plugin (default)
Development in IntelliJ
You can run the server from IntelliJ:
- Open the project via Git clone
- Navigate to
Main.kt - Click the play ▶️ icon to start
Tools Provided
Example Use Case
You can run the search + math + interface agent example via PyCharm or terminal.
Agents:
- Search Agent: Finds information
- Math Agent: Performs calculations
- Interface Agent: Handles user input/output
Interaction: Ask the system a question like:
“What is six times the area of Norway?”
The system will use Coral to:
- Search for Norway’s area
- Delegate calculation to Math Agent
- Return the final response via Interface Agent
Connecting via Inspector
If using SSE mode, connect to the Coral Server:
This guide covered the basics of running the Coral Server in local mode.