Skip to main content
POST
/
api
/
v1
/
tool-packs
/
{tool_pack_id}
/
registered-users
/
{registered_user_id}
/
mcp
curl --request POST \
--url https://ah-api.merge.dev/api/v1/tool-packs/{tool_pack_id}/registered-users/{registered_user_id}/mcp \
--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

Use method "tools/list" to list all available tools (no params required) or method "tools/call" to execute a specific tool (requires params.name and params.arguments)

  • Option 1
  • Option 2

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

Method name. Must be "tools/list".

Available options:
tools/list
Example:

"tools/list"

Response

200 - application/json

For tools/list: returns result.tools array. For tools/call: returns result.content array with tool execution results.

  • Option 1
  • Option 2

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

I