Search Tools

import requests
url = "https://ah-api.merge.dev/api/v1/tool-packs/134e0111-0f67-44f6-98f0-597000290bb3/registered-users/91b2b905-e866-40c8-8be2-efe53827a0aa/search"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, headers=headers)
print(response.json())

{
  "tools": [
    {
      "name": "create_issue",
      "fully_qualified_name": "linear__create_issue",
      "human_name": "create_issue",
      "description": "Creates a new issue in Linear",
      "input_schema": {
        "type": "object",
        "required": [
          "input"
        ],
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "teamId": {
                "type": "string"
              }
            }
          }
        }
      },
      "relevance_score": 0.95,
      "reasoning": "The 'create_issue' tool directly matches the user's intent to create a new ticket in Linear."
    },
    {
      "name": "create_issue",
      "fully_qualified_name": "jira__create_issue",
      "human_name": "create_issue",
      "description": "Creates a new issue in Jira",
      "input_schema": {
        "type": "object",
        "required": [
          "input"
        ],
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "summary": {
                "type": "string"
              },
              "projectKey": {
                "type": "string"
              }
            }
          }
        }
      },
      "relevance_score": 0.88,
      "reasoning": "The 'create_issue' tool in Jira can be used to create tickets in the project management system."
    }
  ],
  "total_results": 2,
  "intent": "I need to create a new ticket in our project management system"
}

Search for tools based on user intent

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Path parameters

registered_user_idstringRequiredformat: "uuid"

Agent Handler ID of the Registered User

tool_pack_idstringRequiredformat: "uuid"

Agent Handler ID of the Tool Pack

Request

This endpoint expects an object.

intentstringRequired<=500 characters

User's intent or what they want to accomplish

connector_slugslist of stringsOptional

Optional list of connector slugs to filter the search

max_resultsintegerOptional1-50Defaults to 10

Maximum number of results to return

Response

Successfully found tools matching the intent

toolslist of objects or null

total_resultsinteger or null

intentstring or null