Merge API Documentation

Endpoint to list tools and call a tool. Use the tools/list method to retrieve available tools, and the tools/call method to execute a specific tool. Implements the JSON-RPC 2.0 MCP specification.

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Path parameters

registered_user_idstringRequired

tool_pack_idstringRequiredformat: "uuid"

Query parameters

authenticated_onlybooleanOptionalDefaults to false

When true, only return tools for connectors the registered user has already authenticated, and hide per-connector authenticate_* tools.

connectorslist of stringsOptional

Restrict tools/list and tools/call to one or more connectors. For multiple values, repeat the param (?connectors=slack&connectors=github) or use comma-separate values (?connectors=slack,github).

formatenumOptional

Allowed values:

Request

This endpoint expects an object.

jsonrpcstringRequired

methodenumRequired

Allowed values:

idintegerOptional

paramsobjectOptional

Response

JSON-RPC 2.0 response

jsonrpcstring

idinteger

resultobject

$	curl -X POST https://ah-api.merge.dev/api/v1/tool-packs/tool_pack_id/registered-users/registered_user_id/mcp/ \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"jsonrpc": "2.0",
>	"method": "tools/list",
>	"id": 1
>	}'

1	{
2	"jsonrpc": "2.0",
3	"id": 1,
4	"result": {
5	"tools": [
6	{
7	"name": "create_issue",
8	"description": "Create a new issue",
9	"inputSchema": {
10	"type": "object",
11	"properties": {
12	"title": {
13	"type": "string"
14	}
15	}
16	}
17	}
18	]
19	}
20	}