cURL
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": "<string>", "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" }
Search for tools based on user intent
Token-based authentication with required prefix "Bearer"
Agent Handler ID of the Registered User
Agent Handler ID of the Tool Pack
User's intent or what they want to accomplish
500
Optional list of connector slugs to filter the search
Maximum number of results to return
1 <= x <= 50
Successfully found tools matching the intent
Show child attributes