## Prerequisites

- An account at [useagents.site](/content/site-root.html)
- An organization (created automatically when you sign up)
- A tool website, repository, or documentation link you can attach to the listing

## Step 1: Create a tool

1. Go to the [dashboard](/content/dashboard/index.html) and click **Add Your Tool** (or **Add Tool**).
2. Enter the **name** and **slug** for your tool. The slug is the URL-friendly identifier (e.g. `my-auth-sdk`).
3. Optionally add an **image** URL for your tool’s logo.

Your tool starts in **draft** status. It won’t appear in the registry or search until you publish it.

## Step 2: Fill in metadata

Edit your tool to add the metadata agents use to discover and understand it. See [Editing Your Tool](/content/docs/creators/editing-tools/index.html) for a full field reference and validation rules.

| Field                  | Description                                                  |
|------------------------|-------------------------------------------------------------|
| **Name**               | Display name of your tool                                    |
| **Short description**  | Tagline (10–160 characters)                                 |
| **Description**        | Full description of what the tool does                      |
| **Website**            | Your tool’s homepage                                        |
| **Repo URL**           | GitHub or other source repository                           |
| **Docs URL**           | Documentation link                                          |
| **Categories**         | e.g. Authentication, CLI, SDK, API                         |
| **Languages**          | e.g. TypeScript, Python, Go                                 |
| **Frameworks**         | e.g. React, Next.js                                         |
| **Tags**               | Up to 15 tags for search (max 30 chars each)               |

The more accurate and complete your metadata, the better agents can find and use your tool.

## Step 3: Review and publish

1. Review the draft content and confirm every link points to the canonical site, repo, or docs.
2. Check that the description explains what the tool does, not just marketing language.
3. Confirm the categories, languages, frameworks, and tags reflect the actual integration surface.
4. Publish the tool to make it live in the registry.

## Verify the result

After publishing:

1. Open the tool’s public page in the registry.
2. Confirm the title, description, and links are correct.
3. Use the MCP server or search UI to verify the tool is discoverable for relevant queries.

## Next steps

- [Reviewing Changes](/content/docs/creators/changes/index.html) – Review your draft changes before deploying.
- [Publishing & Deployments](/content/docs/creators/publishing/index.html) – Deploy your tool to make it live in the registry.