If you’re reading this section, you probably have a product that AI agents can use as a tool. We’re glad you’re here!

Adding tools is easy once you understand the project structure. A few things need to be done for a tool to be considered completely supported:

1

Create a config for your tool

  • Create a new tool config at agentstack/tools/<your_tool>.json
  • As an example, look at our tool config fixture
  • AgentStack uses this to know what code to insert where. Follow the structure to add your tool.
2

Create your implementation for each framework

  • In agentstack/templates/<framework>/tools, you’ll see other implementations of tools.
  • Build your tool implementation for that framework. This file will be inserted in the user’s project.
  • The tools that are exported from this file should be listed in the tool’s config json.
3

Test your tool

Manually test your tool integration by running agentstack tools add <your_tool> and ensure it behaves as expected.

4

Open a PR to add your tool to the next release

​
Tool Config

  • name (str) - Name of your tool
  • category (str) - Category your tool belongs in
  • tools (List[str]) - The exported functions within your tool file
  • url (str) - URL to where developers can learn more about your tool
  • tools_bundled (bool) - True if the tool file exports a list of tools
  • cta (str) - Call To Action printed in the terminal after install
  • env (dict) - Key: Environment variable name; Value: default value
  • packages (List[str]) - Python packages to be installed to support your tool
  • post_install (str) - A script to be run after install of your tool
  • post_remove (str) - A script to be run after removal of your tool
How To Contribute