Skip to main content
POST
/
api
/
v1
/
tool-packs
/
{tool_pack_id}
/
registered-users
/
{registered_user_id}
/
tools
/
call
Call Tool
curl --request POST \
  --url https://ah-api.merge.dev/api/v1/tool-packs/{tool_pack_id}/registered-users/{registered_user_id}/tools/call \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 2,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "linear__list_issue_statuses",
    "arguments": {
      "input": {
        "filter": {
          "team": {
            "id": "14db00ad-1e27-41bb-b30d-b9dc80eec82c",
            "key": null,
            "name": null
          },
          "id": null,
          "name": null,
          "type": null,
          "position": null,
          "description": null
        }
      },
      "forward_pagination": {
        "cursor": null,
        "limit": 20
      }
    }
  }
}'
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"nodes\": [], \"pageInfo\": {\"hasNextPage\": false, \"hasPreviousPage\": false, \"startCursor\": null, \"endCursor\": null}}"
      }
    ]
  }
}

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 calling a specific tool

id
integer
required

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

Example:

2

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/call".

Available options:
tools/call
Example:

"tools/call"

params
object
required

Parameters for calling the tool

Response

200 - application/json

Successfully executed tool

JSON-RPC 2.0 response from calling a tool

jsonrpc
string
required

JSON-RPC protocol version

Example:

"2.0"

id
integer
required

Request identifier that matches the request

Example:

2

result
object
required

Result object containing the tool execution output