The following steps will get you setup to use tools via the Hub API.
Start by registering a new account for Superface.
Think about which tools you want to be able to access via the Hub API. You can add any tools that Superface has already built from the Tools section.
If you want to add your own tools, you can do this by using our Tool Authoring system. You can see more about how to do this in the Create Tools documentation.
If you are expecting that users will provide their own credentials for these tools in order to use them in your agent, or application, you don't need to configure them any further.
After adding some tools (you'll have the Wttr.in tool by default). They will show up in your Tool Function Definitions schema. This schema is used by LLMs to understand which tools are available and what they can do.
You can find yours by clicking on Hub, and selecting Hub API.
You can see what the definitions look like by clicking on Function Definitions JSON. This will show you the JSON schema that will be returned from the /fd endpoint when called.
There are two ways to handle how tools are authenticated when using Hub API. You must choose the option that best suits your end use case.
Use my credentials: If you plan on only using your own accounts, or private APIs that you and your colleagues have access to then Use my credentials is fine. You will need to configure these tools from the Tools section if you choose this.
Users provide their own credentials: If you are going to offer public access to an agent, or application, and require that users provide their own account credentials for the tools on offer, choose Users provide their own credentials. This will ensure that they are prompted to authenticate securely before a tool can be used.
That's all the setup that is required in the Superface interface. Your Hub now has tools and is ready for you to start building your implementation.