> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trypopcorn.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools showcase

> Add a custom tool that another Popcorn account shared, or publish your own to the Tools showcase when it meets the sharing rules.

The Tools showcase, called the marketplace on the agent page, is where custom tools are shared between Popcorn accounts. Open it with **Open marketplace** in the **Tools** panel on an agent's **Actions** tab, or with **Tools showcase** on the **Tools** page. Anything listed there was published by a Popcorn account and can be added to yours.

## Add a shared tool to your workspace

**1. Find the tool**

In the showcase, use **Search tools** to filter by name or description, then click a tool. When nothing matches, the page reads **No tools match "…"** with **Clear search**.

**2. Read what it does**

The tool's page shows its image and description. **After you add it** lists the four steps that follow: open the tool from your tools list, add your own header values such as your API key, save the tool, and turn it on from an agent.

**3. Add it**

Click **Add to my tools**. You see **Tool added** and return to the **Tools** page, where the copy now appears. If it cannot be added you see **Couldn't add this tool. Try again.**

**4. Enter your own credentials**

Open the copy from **Tools**, fill in every header **Value** (they are empty on purpose), review the URL and parameters, and click **Save changes**.

**5. Connect it to an agent**

Open the agent, switch the tool on in the **Tools** panel on its **Actions** tab, then click **Save and review** and **Publish changes**. Test it in **Test your agent**. See [Create a custom tool](https://docs.trypopcorn.ai/tools/create-a-tool.md) for the full connection and testing steps.

What you get:

* The copy is yours: edit it, rename it, or delete it without affecting the original or anyone else's copy.
* Updates the author makes later do not reach your copy. Add the tool again if you want the newer version, then delete the old copy.
* The copy is private to your workspace unless you share it yourself and it meets the rules below.

## Share your own tool

> [!WARNING]
>
> Shared tools are visible to every Popcorn account, not only your team. Popcorn only accepts tools that cannot carry anyone's credentials, so most tools stay private to your workspace.

A tool can be published only when all of these are true:

| Rule | Detail |
| - | - |
| Reviewed public API host | The **URL** is an `https://` address on a host Popcorn has reviewed as a public API. At the moment those are the Salla and Zid APIs (`api.salla.dev` and `api.zid.sa`). A tool that calls your own API stays private. |
| Standard address | No custom port, username, password or `#` fragment; the path uses only standard segments (for example `api`, `orders`, `products`, `customers`, or a version such as `v1`) and placeholders such as `{orderId}`; any `?` options are limited to static ones such as a version, format, language or paging number. |
| No credentials | No parameter has a **Fixed value**, no parameter is named like a credential (for example `api_key`, `token`, `password` or `secret`), and no header name, tool name or description looks like a pasted key or token. |

If a tool does not qualify, **Publish tool** fails with **Couldn't publish this tool**.

### What is shared

| Shared | Not shared |
| - | - |
| Name, description and image | Header **values** (keys, tokens) |
| Method and URL | Your agents or conversations |
| Header **names** | |
| Query and body parameters, with their descriptions and sources | |

Someone who adds your tool gets a copy with empty header values and must enter their own. They cannot see yours. Because other accounts' agents will read your tool exactly as you wrote it, check that the **Description** and parameter descriptions explain the tool to someone who has never seen your system.

### Publish it

**1. Save the tool first**

Publishing shares the saved tool. Open it from the **Tools** page; if you have unsaved edits, the panel reads **Save your changes before publishing.**

**2. Add an image**

In the **Tools showcase** panel beside the form ("Share this tool so other Popcorn AI accounts can add it."), choose an image under **Image**: JPG, PNG, GIF or WebP, up to 5 MB. A different type or a larger file shows **Use a JPG, PNG, GIF or WebP image up to 5 MB.** **Publish to showcase** stays disabled until an image is set (**Add an image to publish.**).

**3. Publish it**

Click **Publish to showcase**. The dialog **Publish *name* to the showcase?** explains that other Popcorn AI accounts will see its name, description and image, can add a copy with its URL and parameters, and do not get your header values. Click **Publish tool**.

You see **Published to the showcase**, the panel reads "Other Popcorn AI accounts can find and add this tool.", the tool's page shows an **In showcase** badge, and the **Tools** page lists the badge in its **Showcase** column. You can replace the image later and save; saving a shared tool also refreshes its showcase copy, and if that fails you see **Tool saved, but its showcase copy wasn't updated**.

There is no way to make a shared tool private again from the dashboard ("You can't unpublish it here").

## Remove a tool from the showcase

Delete the tool: on the **Tools** page, open the **⋯** menu on its row, choose **Delete** and confirm with **Delete tool**. The listing disappears from the showcase. Copies that other accounts already added keep working, because each copy is independent.

Deletion is refused while one of your agents has the tool switched on. Switch it off in the **Tools** panel on the agent's **Actions** tab, save the agent, then delete.

## Related

* [Custom tools overview](https://docs.trypopcorn.ai/tools/overview.md)
* [Create a custom tool](https://docs.trypopcorn.ai/tools/create-a-tool.md)
* [Knowledge, tools, channels and notifications on the agent page](https://docs.trypopcorn.ai/agents/connect-knowledge-tools-channels.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.