Guide: How to Publish Your Agent on the Coral Protocol Marketplace

This guide will walk you through the process of getting your agent set up and published on the Coral Protocol marketplace. https://github.com/Coral-Protocol/marketplace Here are some resources to help you get started: https://youtu.be/SDaq3Sl-QmA

1. Set Up Your Wallet

1.1 Create and configure your wallet

Follow this guide to set up your wallet: 👉 Coral Protocol Payments Documentation

2. Prepare Your Agent


2.1 coral-agent.toml

Where you’ll find it: The file defines how an AI agent called ca-context7 should behave, what options it accepts, and how it is run Example:
[agent]
name = "ca-context7"
version = "0.1.0"
description = "An agent capable of accessing up to date documentation for many software tools and libraries"

[options]
LIBRARY_ID = { type = "string", description = "The context7 library ID to get documentation for.  E.g websites/coralprotocol" }
OPENROUTER_API_KEY = { type = "string", description = "The OpenRouter API key to use" }
SYSTEM_PROMPT_SUFFIX = { type = "string", description = "Optional suffix to include in the system prompt", default = "" }
LOOP_PROMPT_SUFFIX = { type = "string", description = "Optional suffix to include in the loop prompt", default = "" }
TEMPERATURE = { type = "number", description = "Temperature hyperparameter", default = 0.20 }
MAX_TOKENS = { type = "string", description = "Maximum number of tokens to use in one completion request", default = "8192" }
ENABLE_TELEMETRY = { type = "string", description = "Maximum number of tokens to use in one completion request", default = "false" }
LOOP_DELAY = { type = "string", description = "The delay to use between loop iterations.  Format is https://docs.rs/humantime/2.2.0/humantime/", default = "1s" }
LOOP_MAX_REPS = { type = "string", description = "Maximum number of loop repitions to make before the agent exits", default = "512" }

[runtimes.docker]
image = "coralprotocol/ca-context7"

2.2 Docker Image

Where you’ll find it: After building your agent with Docker, your image will be in your local Docker registry (check with docker images). You can also push it to Docker Hub or another registry for remote access. Example:
...

2.3 Export Settings

Where you’ll find it: This defines how your agent is priced and listed. The configuration is usually part of your registry file in https://github.com/Coral-Protocol/coral-server/blob/master/src/main/resources/full-registry.toml - starting from this header: [local-agent.export.docker] Example:
[local-agent.export.docker]

# The quantity field describes how many concurrent agents of this type in this runtime can be exported; this is to allow
# basic control over
quantity = 20

# The pricing table is mostly a placeholder until payments are implemented
pricing = { min_price = { type = "usd", amount = 1.00 }, max_price = { type = "usd", amount = 10.0 } }

# The agent export options table allows providing values for certain options when a remote server requests this agent.
# This is useful when you want to export an agent that takes an API key, but don't want the end user to use their own
# api key
options.API_KEY = { type = "string", value = "my api key" }

2.4 wallet.toml and crossmint-keypair.json

Where you’ll find it:
cd ~/.coral
ls
crossmint-keypair.json	registry		wallet.toml
pwd
/Users/your-name/.coral
These files is created when you set up your Coral wallet for the first time. It stores your wallet configuration.

3. Submit to the Marketplace

3.1 Deploy your agent

To have your agent deployed and listed, you will need to send the following to hello@coralprotocol.org: