Skip to main content
POST
/
api
/
v1
/
tool-packs
/
{tool_pack_id}
/
registered-users
/
{registered_user_id}
/
search
Search Tools
curl --request POST \
  --url https://ah-api.merge.dev/api/v1/tool-packs/{tool_pack_id}/registered-users/{registered_user_id}/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "intent": "I need to create a new ticket in our project management system",
  "connector_slugs": [
    "linear"
  ],
  "max_results": 10
}'
{
  "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"
}

Authorizations

Authorization
string
header
required

Token-based authentication with required prefix "Bearer"

Path Parameters

registered_user_id
string<uuid>
required

Agent Handler ID of the Registered User

tool_pack_id
string<uuid>
required

Agent Handler ID of the Tool Pack

Body

intent
string
required

User's intent or what they want to accomplish

Maximum length: 500
connector_slugs
string[]

Optional list of connector slugs to filter the search

max_results
integer
default:10

Maximum number of results to return

Required range: 1 <= x <= 50

Response

200 - application/json

Successfully found tools matching the intent

tools
object[]
total_results
integer
intent
string