Skip to main content
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 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

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: If a tool does not qualify, Publish tool fails with Couldn’t publish this tool.

What is shared

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.