An implementation of the Coral Protocol that acts as an MCP server providing tools for agents to communicate with each other.
This project implements a Model Context Protocol (MCP) server that facilitates communication between AI agents through a thread-based messaging system.
Currently, it provides a set of tools that allow agents to:
- Register themselves in the system
- Create and manage conversation threads
- Send messages to threads
- Mention other agents in messages
- Receive notifications when mentioned
Clone this repository, and in that folder run:
./gradlew runCoral Server is available on ghcr.io:
docker run \
-p 5555:5555 \ # expose port 5555 from the container
-v /path/to/your/registry.toml:/config/registry.toml # mount your registry.toml
-v /var/run/docker.sock:/var/run/docker.sock # mount the docker socket to support docker agents
ghcr.io/coral-protocol/coral-serverWarning
Our Coral Server docker image is very minimal - which means the executable runtime will not work. All agents you use must use the Docker runtime, which means you must give your server container access to your host's docker socket.
See here for more information on giving your docker container access to Docker.
Coral Server has two files for configuration - config.toml, which has general configuration options like port, docker socket, etc, and registry.toml, which defines the agent registry for your server.
Tip
To get a sense of all available options, see full-config.toml & full-registry.toml
Note
While coral server has default config files, it's recommended you create your own registry.toml/config.toml, and point coral server to them with the REGISTRY_FILE_PATH/CONFIG_FILE_PATH environment variables.
Open infrastructure for the Society of AI Agents
It's a strange concept; we believe that much of what we now consider work will be handled by a different kind of society—a Society of AI Agents.
To bridge this gap, Coral Protocol was built as the connective tissue of this society. Coral is designed to enable agents to discover one another, communicate securely, exchange value, and scale their collaborative efforts from any framework.
We theorize that not only will this fix many problems with the composability of multi-agent systems, but it will also unlock their full potential to be much more capable and safe, this is due to the graph-like structure that prevents any one agent from holding too much power or becoming overwhelmed with too much responsibility.
We welcome contributions! Email us at [email protected] or join our Discord here to connect with the developer team. Feel free to open issues or submit pull requests.
Thanks for checking out the project, we hope you like it!
IntelliJ IDEA is recommended for development. The project uses Gradle as the build system.
To clone and import the project:
Go to File > New > Project from Version Control > Git.
enter [email protected]:Coral-Protocol/coral-server.git
Click Clone.
You can click the play button next to the main method in the Main.kt file to run the server directly from IntelliJ IDEA.