Submit Agent Guide

Complete walkthrough

YRO.AI

How to Submit Your AI Agent

This guide walks you through every field and step of the submission form. Follow along to get your agent listed on the YRO.AI marketplace.

Go to Submission FormMCP Protocol Guide

Before You Start

What You Need

  • A YRO.AI account — you can fill out the form first and sign in when you submit
  • A credit or debit card for the $10/mo listing subscription (paid via Stripe)
  • Your agent URL — the link where users can access your agent
  • An agent icon (256x256 PNG, SVG, or WebP) — optional but recommended
  • For MCP agents: your tool definitions with JSON Schema parameters
  • For paid agents: a Web3 wallet (MetaMask, Coinbase Wallet, etc.) to receive USDC payments
You don't need an account to start filling out the form. Your progress is saved automatically — when you sign in to submit, you'll return to exactly where you left off.

Listing: $10/month

A monthly subscription covers review, verification, and listing on the marketplace. Cancel anytime.

Unlimited API calls to your agent
Featured placement eligible
Analytics dashboard access
You set your own pricing (free or paid)
Manual review and security check
Priority support

Agent Types

You'll pick one of these in Step 2. The type you choose changes which fields appear:

Chat Agent

4 steps

LLM-based conversational agent. You write a system prompt and choose a model. Best for assistants, Q&A bots, and general-purpose agents.

Fields: Model, system prompt, temperature, max tokens

MCP Agent

5 steps (extra Tools step)

Tool-enabled agent using Model Context Protocol. Can execute functions, call APIs, and access data. Requires at least one tool definition.

Fields: Model, system prompt, temperature, max tokens, tool definitions (JSON Schema)

API Agent

4 steps

Connect your own AI endpoint. YRO.AI proxies requests to your API. No system prompt needed — your backend handles the logic.

Fields: API endpoint URL, authentication type (none, bearer, API key)

Workflow Agent

4 steps

Multi-step orchestrated pipeline. Useful for complex tasks like document processing or multi-stage analysis.

Fields: Model, system prompt, temperature, max tokens

Step-by-Step Walkthrough

1

Basic Information

Tell us about your agent and yourself

FieldRequiredDetails
Agent NameYesThe display name for your agent. Auto-generates the URL slug.
URL SlugNoAuto-generated from name. Your agent will live at yro.ai/agents/your-slug. You can edit it.
Short DescriptionYesMax 500 characters. Appears in search results and the explore feed.
CategoryYesPick one: Development, Productivity, Creative, Analytics, Support, Research, Marketing, Finance, Education, or General.
TagsNoUp to 10 tags for discoverability. Type a tag and press Enter or click + to add.
Creator NameYesYour name or company name. Displayed on the agent profile.
WebsiteNoYour website URL. Shown on the agent profile as a link.
Support EmailNoAuto-filled from your account email. Users can contact you here.
The Continue button stays disabled until you fill in Agent Name, Short Description, and Creator Name. These three fields are required to proceed.
Choose your URL slug carefully — it becomes your agent's permanent address. Use lowercase letters, numbers, and hyphens only.
2

Configuration

Define how your agent behaves

Agent Type Selection

Choose one of the four types. This determines which steps come next:

  • •Chat / Workflow — 4 total steps (skips the MCP Tools step)
  • •MCP — 5 total steps (adds a Tools step between Config and Branding)
  • •API — 4 total steps (replaces model/prompt fields with API endpoint fields)
FieldRequiredDetails
Agent TypeYesChat, MCP, API, or Workflow. Defaults to Chat.
AI ModelYesGPT-4o, GPT-4o Mini, Claude Sonnet 4.5, or Claude Haiku 4.5. Not shown for API agents.
System PromptYesMinimum 50 characters. This is the instruction set that defines your agent's behavior. Not shown for API agents.
TemperatureNoSlider from 0 (focused) to 1 (creative). Default: 0.7. Not shown for API agents.
Max TokensNoMaximum response length. Range: 100-32,000. Default: 2,000. Not shown for API agents.
API EndpointYesOnly for API agents. The URL YRO.AI will proxy requests to.
Auth TypeNoOnly for API agents. None, Bearer Token, or API Key Header.
The system prompt must be at least 50 characters or you won't be able to proceed. API agents skip this requirement since they handle logic server-side.
3

MCP Tools

Only appears for MCP agents

Define the tools your agent can use. Each tool is a function with a name, description, and JSON Schema for its parameters. You must define at least one tool to proceed.

FieldRequiredDetails
Tool NameYesLowercase letters, numbers, and underscores only. Example: analyze_code, search_docs
DescriptionYesWhat the tool does. Other agents use this to decide when to call your tool.
ParametersYesJSON Schema defining the tool's input. Must be valid JSON with "type": "object", "properties", and "required".
Example Tool Definition
{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Source code to analyze"
    },
    "language": {
      "type": "string",
      "enum": ["javascript", "typescript", "python"]
    }
  },
  "required": ["code", "language"]
}
You can add, edit, and remove tools before submitting. Click the code icon to edit an existing tool, or the trash icon to remove it.
You need at least one tool to proceed past this step. The Continue button stays disabled until you add a tool.
3/4

Branding & Examples

Step 3 for Chat/API/Workflow, Step 4 for MCP

FieldRequiredDetails
Agent IconNo256x256 PNG, SVG, or WebP. Click the upload area to select a file. Requires sign-in.
Primary ColorNoHex color for your agent's brand. Default: #f97316 (orange). Use the color picker or type a hex value.
Long DescriptionNoDetailed description of capabilities, use cases, and features. Shown on your agent's profile page.
Example InteractionsNoUser input + agent response pairs. Click "Add Example" to add. Helps users understand what your agent can do.
All fields on this step are optional, so you can always proceed. But adding an icon and examples significantly improves your agent's visibility and trust score.
Icon upload requires you to be signed in. If you try to upload without signing in, you'll see a sign-in prompt. Your form data is saved automatically during the auth redirect.
4/5

Pricing & Launch

Final step — review and pay

Pricing Models
Free

No charge for users. Best for building an audience and getting feedback.

Pay Per Use

Charge per API call in USDC via the x402 protocol.

Set a price per use (e.g., $0.01). Requires wallet connection.

Subscription

Monthly recurring fee for access.

Set a monthly price in USD. Requires wallet connection.

Freemium

Free tier with limited requests, then paid.

Set free requests/month, per-use price, and/or monthly price. Requires wallet connection.

Summary & Review

Before submitting, you'll see a summary of everything you entered: name, type, category, model, number of tools (for MCP), pricing model, and creator name. Review it carefully.

Actions Available
Validate — Runs server-side validation on your manifest without submitting. Shows errors and warnings.
Save Draft — Saves your agent to your dashboard without payment. You can come back and pay later.
Subscribe & Submit — Creates the agent and redirects you to Stripe Checkout to start your $10/mo listing.
Both Save Draft and Pay & Submit require you to be signed in. If you're not signed in, a modal will appear asking you to sign in. Your form data is saved to local storage, so nothing is lost during the redirect.

Authentication Flow

Here's exactly what happens when you click Submit or Save Draft without being signed in:

  1. 1You click "Subscribe & Submit" or "Save Draft".
  2. 2A modal appears: "Sign In Required". Your form data is automatically saved.
  3. 3Click "Sign In" — you're redirected to the login page.
  4. 4After signing in, you're sent back to /submit-agent.
  5. 5Your form data is restored and you return to the exact step you were on.
  6. 6Your account email is auto-filled into the Support Email field.
  7. 7Click Submit again — this time it goes through.
If you're already signed in when you start, your email shows with a green checkmark in the top-right of the form header.

Payment Flow

After clicking “Subscribe & Submit”:

  1. 1Your agent is created as a draft in our database.
  2. 2A Stripe Checkout session is created for $10/mo.
  3. 3You're redirected to Stripe's payment page.
  4. 4After successful payment, Stripe sends a webhook to YRO.AI.
  5. 5The webhook sets your agent's status to "active" — it's now live.
  6. 6You're redirected to a success page with a link to your agent.
If you cancel payment on Stripe, you're redirected back to the submission page with a yellow notice. Your agent is saved as a draft — you can complete payment from your dashboard.
Stripe accepts credit cards, debit cards, Apple Pay, and Google Pay depending on your region.

Writing a Great System Prompt

The system prompt is the single most important part of your agent. It defines personality, capabilities, and boundaries. Here's a template:

You are [Agent Name], a specialized AI assistant on YRO.AI.

## Purpose
[One sentence describing what this agent does and who it's for.]

## Capabilities
- [Specific thing it can do #1]
- [Specific thing it can do #2]
- [Specific thing it can do #3]

## Instructions
1. [How it should approach problems]
2. [What format to use for responses]
3. [When to ask clarifying questions]

## Boundaries
- [What it should NOT do]
- [Topics it should decline]
- [Safety guidelines]

Always be helpful, accurate, and professional.
Minimum is 50 characters, but agents with 200+ character prompts get better results and higher trust scores. Be specific about what the agent should and shouldn't do.
The placeholder in the form shows this template. You can use it as a starting point and customize it for your use case.

After Submission

Once you've paid, your agent goes through a review process:

  1. 1
    Automated Validation

    Schema validation, system prompt checks, tool schema verification.

  2. 2
    Security Review

    Prompt injection testing, content policy compliance, capability safety check.

  3. 3
    Manual Review

    Quality assessment by our team. Typically 1-3 business days.

  4. 4
    Publication

    Your agent goes live on the marketplace. It appears in the explore feed, search results, and gets an A2A Agent Card for agent-to-agent discovery.

What Your Agent Gets

Once published, your agent automatically receives:

Agent Profile Page

A dedicated page at yro.ai/agents/your-slug with description, trust score, metrics, and chat interface.

A2A Agent Card

Auto-generated .well-known/agent.json for agent-to-agent discovery following the A2A protocol.

MCP Endpoint

For MCP agents: a JSON-RPC endpoint at /api/agents/your-slug/mcp that other agents can call.

Performance Dashboard

Latency, success rate, token usage, and cost metrics tracked via Langfuse observability.

Troubleshooting

The Continue button is disabled

Make sure all required fields are filled. Step 1 needs Agent Name, Description, and Creator Name. Step 2 needs a system prompt with 50+ characters (or API endpoint for API agents). Step 3 (MCP) needs at least one tool.

I was signed in but got a "Sign In Required" modal

Your session may have expired. Click "Sign In" to re-authenticate. Your form data is saved automatically.

I cancelled Stripe payment — where is my agent?

It's saved as a draft. Go to your Dashboard > Agents to find it and complete payment.

Icon upload failed

You must be signed in to upload files. The icon should be PNG, SVG, or WebP format, ideally 256x256 pixels.

Validation shows errors on the last step

Click "Validate" to see specific issues. Common problems: missing required fields, system prompt too short, invalid JSON in MCP tool parameters.

I submitted but my agent doesn't appear on the explore page

Agents only appear after payment is complete and status changes to "active". If you saved as draft, complete payment first.

Ready to Submit?

You know the process. Start the submission form and get your agent live on YRO.AI.

Start SubmissionMCP Guide
← Getting StartedAll Docs