List available tools

curl --request GET \
  --url https://asteragents.com/api/tools \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://asteragents.com/api/tools', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://asteragents.com/api/tools",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://asteragents.com/api/tools"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://asteragents.com/api/tools")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "total": 3,
  "tools": [
    {
      "name": "scrape_url",
      "displayName": "Scrape URL",
      "description": "Scrape content from a given URL using the Firecrawl API",
      "category": "Research",
      "requiredIntegration": null,
      "isPrivate": false,
      "available": true,
      "parameters": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "The URL to scrape"
          }
        }
      }
    },
    {
      "name": "search_knowledge_base",
      "displayName": "Search Knowledge Base",
      "description": "Search through a specific knowledge base for relevant information.",
      "category": "Aster Agents Platform",
      "requiredIntegration": null,
      "isPrivate": false,
      "available": true,
      "parameters": {
        "type": "object",
        "required": [
          "query",
          "knowledge_base_id"
        ],
        "properties": {
          "query": {
            "type": "string",
            "description": "The search query"
          },
          "knowledge_base_id": {
            "type": "integer",
            "description": "The ID of the knowledge base to search"
          }
        }
      }
    },
    {
      "name": "google:code_execution",
      "displayName": "Code Execution",
      "description": "Generate and run Python code",
      "category": "Google AI",
      "isProviderTool": true,
      "provider": "google",
      "available": true
    }
  ]
}

Tools API

List available tools

Returns the catalog of tools the caller’s organization can attach to an agent.

The default response is filtered to only include tools the org can use right now:

Tools requiring an integration are excluded if the org hasn’t connected it
Private tools are excluded unless enabled by an org admin
Companion tools (auto-attached when their parent is enabled) are excluded

Each entry’s name + parameters + description matches the shape stored under an agent’s tools JSONB. To attach a tool to an agent, copy the relevant entries from this response into the tools field of POST /agents, keyed by name. Provider tools (isProviderTool: true) are passed under their name (e.g., google:code_execution) with { isProviderTool: true }.

The set of available tools changes as integrations are connected, private tools are toggled in org settings, and new platform tools ship. Call this endpoint at agent-build time rather than caching the catalog.

GET

tools

List available tools

curl --request GET \
  --url https://asteragents.com/api/tools \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://asteragents.com/api/tools', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://asteragents.com/api/tools",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://asteragents.com/api/tools"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://asteragents.com/api/tools")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "total": 3,
  "tools": [
    {
      "name": "scrape_url",
      "displayName": "Scrape URL",
      "description": "Scrape content from a given URL using the Firecrawl API",
      "category": "Research",
      "requiredIntegration": null,
      "isPrivate": false,
      "available": true,
      "parameters": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "The URL to scrape"
          }
        }
      }
    },
    {
      "name": "search_knowledge_base",
      "displayName": "Search Knowledge Base",
      "description": "Search through a specific knowledge base for relevant information.",
      "category": "Aster Agents Platform",
      "requiredIntegration": null,
      "isPrivate": false,
      "available": true,
      "parameters": {
        "type": "object",
        "required": [
          "query",
          "knowledge_base_id"
        ],
        "properties": {
          "query": {
            "type": "string",
            "description": "The search query"
          },
          "knowledge_base_id": {
            "type": "integer",
            "description": "The ID of the knowledge base to search"
          }
        }
      }
    },
    {
      "name": "google:code_execution",
      "displayName": "Code Execution",
      "description": "Generate and run Python code",
      "category": "Google AI",
      "isProviderTool": true,
      "provider": "google",
      "available": true
    }
  ]
}

Authorizations

Authorization

string

header

required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Query Parameters

all

boolean

default:false

When true, include every tool with available: false and an unavailableReason instead of filtering them out. Useful for surfacing "connect this integration to unlock X" hints.

Response

Tool catalog retrieved successfully

tools

object[]

required

Show child attributes

total

integer

required

Number of tools returned

API Documentation

Admin API

Files API

Agents API

Tools API

Agent Tags API

Knowledge Bases API

Skills API

Conversations API

Scheduled Tasks API

Other Endpoints

Legacy Endpoints (Deprecated)

List available tools

Authorizations

Query Parameters

Response