Skip to main content
POST
/
api
/
v1
/
tool-packs
/
{tool_pack_id}
/
registered-users
/
{registered_user_id}
/
tools
/
list
List Tools
curl --request POST \
  --url https://ah-api.merge.dev/api/v1/tool-packs/{tool_pack_id}/registered-users/{registered_user_id}/tools/list \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/list"
}'
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "linear__create_comment",
        "description": "Creates a new comment",
        "inputSchema": {
          "type": "object",
          "required": [
            "input"
          ],
          "properties": {
            "input": {
              "type": "object",
              "title": "CreateCommentInput",
              "required": [
                "issueId",
                "body"
              ],
              "properties": {
                "body": {
                  "type": "string",
                  "description": "Body of the comment."
                },
                "issueId": {
                  "type": "string",
                  "description": "ID of the issue to add the comment to."
                }
              }
            }
          }
        }
      },
      {
        "name": "linear__get_issue",
        "description": "Get a single issue by ID from Linear",
        "inputSchema": {
          "type": "object",
          "required": [
            "input"
          ],
          "properties": {
            "input": {
              "type": "object",
              "title": "GetIssueInput",
              "required": [
                "id"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The ID of the issue."
                }
              }
            }
          }
        }
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Production Access Key (Bearer)

Path Parameters

tool_pack_id
string<uuid>
required

Agent Handler ID of the Tool Pack

registered_user_id
string<uuid>
required

Agent Handler ID of the Registered User

Body

application/json

JSON-RPC 2.0 request for listing available tools

id
integer
required

Request identifier for tracking. Can be any integer value chosen by the client.

Example:

1

jsonrpc
enum<string>
required

JSON-RPC protocol version. Must be "2.0".

Available options:
2.0
Example:

"2.0"

method
enum<string>
required

The JSON-RPC method name. Must be "tools/list".

Available options:
tools/list
Example:

"tools/list"

Response

200 - application/json

Successfully retrieved list of tools

JSON-RPC 2.0 response containing list of available tools

jsonrpc
string
required

JSON-RPC protocol version

Example:

"2.0"

id
integer
required

Request identifier that matches the request

Example:

1

result
object
required

Result object containing the tools array