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.
- 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
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.