Add webhook subscription MCP tools and N8N operations

Expose webhook subscription CRUD and event listing through the MCP API
(list, get, create, update, delete subscriptions + list events) and add
a new webhook resource to the N8N node with matching operations.

Signed-off-by: Sacha Al Himdani <sacha@getprobo.com>
This commit is contained in:
Sacha Al Himdani
2026-04-17 12:16:23 +02:00
parent 7143944fba
commit 9c9c60d0eb
12 changed files with 1200 additions and 0 deletions

View File

@@ -146,6 +146,11 @@ export class Probo implements INodeType {
value: 'vendor',
description: 'Manage vendors',
},
{
name: 'Webhook',
value: 'webhook',
description: 'Manage webhook subscriptions',
},
],
default: 'execute',
},

View File

@@ -27,6 +27,7 @@ import * as user from './user';
import * as risk from './risk';
import * as statementOfApplicability from './statementOfApplicability';
import * as vendor from './vendor';
import * as webhook from './webhook';
export interface ResourceModule {
description: INodeProperties[];
@@ -53,6 +54,7 @@ export const resources: Record<string, ResourceModule> = {
risk: risk as ResourceModule,
statementOfApplicability: statementOfApplicability as ResourceModule,
vendor: vendor as ResourceModule,
webhook: webhook as ResourceModule,
};
export function getAllResourceOperations(): INodeProperties[] {

View File

@@ -0,0 +1,114 @@
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
import type { INodeProperties, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
import { proboApiRequest } from '../../GenericFunctions';
export const description: INodeProperties[] = [
{
displayName: 'Organization ID',
name: 'organizationId',
type: 'string',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['create'],
},
},
default: '',
description: 'The ID of the organization',
required: true,
},
{
displayName: 'Endpoint URL',
name: 'endpointUrl',
type: 'string',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['create'],
},
},
default: '',
description: 'The HTTPS endpoint URL that receives webhook events',
required: true,
},
{
displayName: 'Selected Events',
name: 'selectedEvents',
type: 'multiOptions',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['create'],
},
},
options: [
{ name: 'Meeting Created', value: 'MEETING_CREATED' },
{ name: 'Meeting Deleted', value: 'MEETING_DELETED' },
{ name: 'Meeting Updated', value: 'MEETING_UPDATED' },
{ name: 'Obligation Created', value: 'OBLIGATION_CREATED' },
{ name: 'Obligation Deleted', value: 'OBLIGATION_DELETED' },
{ name: 'Obligation Updated', value: 'OBLIGATION_UPDATED' },
{ name: 'User Created', value: 'USER_CREATED' },
{ name: 'User Deleted', value: 'USER_DELETED' },
{ name: 'User Updated', value: 'USER_UPDATED' },
{ name: 'Vendor Created', value: 'VENDOR_CREATED' },
{ name: 'Vendor Deleted', value: 'VENDOR_DELETED' },
{ name: 'Vendor Updated', value: 'VENDOR_UPDATED' },
],
default: [],
description: 'The event types to subscribe to',
required: true,
},
];
export async function execute(
this: IExecuteFunctions,
itemIndex: number,
): Promise<INodeExecutionData> {
const organizationId = this.getNodeParameter('organizationId', itemIndex) as string;
const endpointUrl = this.getNodeParameter('endpointUrl', itemIndex) as string;
const selectedEvents = this.getNodeParameter('selectedEvents', itemIndex) as string[];
const query = `
mutation CreateWebhookSubscription($input: CreateWebhookSubscriptionInput!) {
createWebhookSubscription(input: $input) {
webhookSubscriptionEdge {
node {
id
endpointUrl
signingSecret
selectedEvents
createdAt
updatedAt
}
}
}
}
`;
const responseData = await proboApiRequest.call(this, query, {
input: {
organizationId,
endpointUrl,
selectedEvents,
},
});
return {
json: responseData,
pairedItem: { item: itemIndex },
};
}

View File

@@ -0,0 +1,57 @@
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
import type { INodeProperties, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
import { proboApiRequest } from '../../GenericFunctions';
export const description: INodeProperties[] = [
{
displayName: 'Webhook Subscription ID',
name: 'webhookSubscriptionId',
type: 'string',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['delete'],
},
},
default: '',
description: 'The ID of the webhook subscription to delete',
required: true,
},
];
export async function execute(
this: IExecuteFunctions,
itemIndex: number,
): Promise<INodeExecutionData> {
const webhookSubscriptionId = this.getNodeParameter('webhookSubscriptionId', itemIndex) as string;
const query = `
mutation DeleteWebhookSubscription($input: DeleteWebhookSubscriptionInput!) {
deleteWebhookSubscription(input: $input) {
deletedWebhookSubscriptionId
}
}
`;
const responseData = await proboApiRequest.call(this, query, {
input: { webhookSubscriptionId },
});
return {
json: responseData,
pairedItem: { item: itemIndex },
};
}

View File

@@ -0,0 +1,61 @@
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
import type { INodeProperties, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
import { proboApiRequest } from '../../GenericFunctions';
export const description: INodeProperties[] = [
{
displayName: 'Webhook Subscription ID',
name: 'webhookSubscriptionId',
type: 'string',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['get'],
},
},
default: '',
description: 'The ID of the webhook subscription',
required: true,
},
];
export async function execute(
this: IExecuteFunctions,
itemIndex: number,
): Promise<INodeExecutionData> {
const webhookSubscriptionId = this.getNodeParameter('webhookSubscriptionId', itemIndex) as string;
const query = `
query GetWebhookSubscription($webhookSubscriptionId: ID!) {
node(id: $webhookSubscriptionId) {
... on WebhookSubscription {
id
endpointUrl
selectedEvents
createdAt
updatedAt
}
}
}
`;
const responseData = await proboApiRequest.call(this, query, { webhookSubscriptionId });
return {
json: responseData,
pairedItem: { item: itemIndex },
};
}

View File

@@ -0,0 +1,114 @@
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
import type { INodeProperties, IExecuteFunctions, INodeExecutionData, IDataObject } from 'n8n-workflow';
import { proboApiRequestAllItems } from '../../GenericFunctions';
export const description: INodeProperties[] = [
{
displayName: 'Organization ID',
name: 'organizationId',
type: 'string',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['getAll'],
},
},
default: '',
description: 'The ID of the organization',
required: true,
},
{
displayName: 'Return All',
name: 'returnAll',
type: 'boolean',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['getAll'],
},
},
default: false,
description: 'Whether to return all results or only up to a given limit',
},
{
displayName: 'Limit',
name: 'limit',
type: 'number',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['getAll'],
returnAll: [false],
},
},
typeOptions: {
minValue: 1,
},
default: 50,
description: 'Max number of results to return',
},
];
export async function execute(
this: IExecuteFunctions,
itemIndex: number,
): Promise<INodeExecutionData> {
const organizationId = this.getNodeParameter('organizationId', itemIndex) as string;
const returnAll = this.getNodeParameter('returnAll', itemIndex) as boolean;
const limit = this.getNodeParameter('limit', itemIndex, 50) as number;
const query = `
query GetWebhookSubscriptions($organizationId: ID!, $first: Int, $after: CursorKey) {
node(id: $organizationId) {
... on Organization {
webhookSubscriptions(first: $first, after: $after) {
edges {
node {
id
endpointUrl
selectedEvents
createdAt
updatedAt
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
}
}
`;
const webhookSubscriptions = await proboApiRequestAllItems.call(
this,
query,
{ organizationId },
(response) => {
const data = response?.data as IDataObject | undefined;
const node = data?.node as IDataObject | undefined;
return node?.webhookSubscriptions as IDataObject | undefined;
},
returnAll,
limit,
);
return {
json: { webhookSubscriptions },
pairedItem: { item: itemIndex },
};
}

View File

@@ -0,0 +1,114 @@
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
import type { INodeProperties, IExecuteFunctions, INodeExecutionData, IDataObject } from 'n8n-workflow';
import { proboApiRequestAllItems } from '../../GenericFunctions';
export const description: INodeProperties[] = [
{
displayName: 'Webhook Subscription ID',
name: 'webhookSubscriptionId',
type: 'string',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['getEvents'],
},
},
default: '',
description: 'The ID of the webhook subscription',
required: true,
},
{
displayName: 'Return All',
name: 'returnAll',
type: 'boolean',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['getEvents'],
},
},
default: false,
description: 'Whether to return all results or only up to a given limit',
},
{
displayName: 'Limit',
name: 'limit',
type: 'number',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['getEvents'],
returnAll: [false],
},
},
typeOptions: {
minValue: 1,
},
default: 50,
description: 'Max number of results to return',
},
];
export async function execute(
this: IExecuteFunctions,
itemIndex: number,
): Promise<INodeExecutionData> {
const webhookSubscriptionId = this.getNodeParameter('webhookSubscriptionId', itemIndex) as string;
const returnAll = this.getNodeParameter('returnAll', itemIndex) as boolean;
const limit = this.getNodeParameter('limit', itemIndex, 50) as number;
const query = `
query GetWebhookEvents($webhookSubscriptionId: ID!, $first: Int, $after: CursorKey) {
node(id: $webhookSubscriptionId) {
... on WebhookSubscription {
events(first: $first, after: $after) {
edges {
node {
id
webhookSubscriptionId
status
response
createdAt
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
}
}
`;
const events = await proboApiRequestAllItems.call(
this,
query,
{ webhookSubscriptionId },
(response) => {
const data = response?.data as IDataObject | undefined;
const node = data?.node as IDataObject | undefined;
return node?.events as IDataObject | undefined;
},
returnAll,
limit,
);
return {
json: { events },
pairedItem: { item: itemIndex },
};
}

View File

@@ -0,0 +1,82 @@
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
import type { INodeProperties } from 'n8n-workflow';
import * as createOp from './create.operation';
import * as updateOp from './update.operation';
import * as deleteOp from './delete.operation';
import * as getOp from './get.operation';
import * as getAllOp from './getAll.operation';
import * as getEventsOp from './getEvents.operation';
export const description: INodeProperties[] = [
{
displayName: 'Operation',
name: 'operation',
type: 'options',
noDataExpression: true,
displayOptions: {
show: {
resource: ['webhook'],
},
},
options: [
{
name: 'Create',
value: 'create',
description: 'Create a new webhook subscription',
action: 'Create a webhook subscription',
},
{
name: 'Delete',
value: 'delete',
description: 'Delete a webhook subscription',
action: 'Delete a webhook subscription',
},
{
name: 'Get',
value: 'get',
description: 'Get a webhook subscription',
action: 'Get a webhook subscription',
},
{
name: 'Get Events',
value: 'getEvents',
description: 'Get delivery events for a webhook subscription',
action: 'Get webhook delivery events',
},
{
name: 'Get Many',
value: 'getAll',
description: 'Get many webhook subscriptions',
action: 'Get many webhook subscriptions',
},
{
name: 'Update',
value: 'update',
description: 'Update a webhook subscription',
action: 'Update a webhook subscription',
},
],
default: 'create',
},
...createOp.description,
...updateOp.description,
...deleteOp.description,
...getOp.description,
...getAllOp.description,
...getEventsOp.description,
];
export { createOp as create, updateOp as update, deleteOp as delete, getOp as get, getAllOp as getAll, getEventsOp as getEvents };

View File

@@ -0,0 +1,107 @@
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
import type { INodeProperties, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
import { proboApiRequest } from '../../GenericFunctions';
export const description: INodeProperties[] = [
{
displayName: 'Webhook Subscription ID',
name: 'webhookSubscriptionId',
type: 'string',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['update'],
},
},
default: '',
description: 'The ID of the webhook subscription to update',
required: true,
},
{
displayName: 'Endpoint URL',
name: 'endpointUrl',
type: 'string',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['update'],
},
},
default: '',
description: 'The HTTPS endpoint URL that receives webhook events',
},
{
displayName: 'Selected Events',
name: 'selectedEvents',
type: 'multiOptions',
displayOptions: {
show: {
resource: ['webhook'],
operation: ['update'],
},
},
options: [
{ name: 'Meeting Created', value: 'MEETING_CREATED' },
{ name: 'Meeting Deleted', value: 'MEETING_DELETED' },
{ name: 'Meeting Updated', value: 'MEETING_UPDATED' },
{ name: 'Obligation Created', value: 'OBLIGATION_CREATED' },
{ name: 'Obligation Deleted', value: 'OBLIGATION_DELETED' },
{ name: 'Obligation Updated', value: 'OBLIGATION_UPDATED' },
{ name: 'User Created', value: 'USER_CREATED' },
{ name: 'User Deleted', value: 'USER_DELETED' },
{ name: 'User Updated', value: 'USER_UPDATED' },
{ name: 'Vendor Created', value: 'VENDOR_CREATED' },
{ name: 'Vendor Deleted', value: 'VENDOR_DELETED' },
{ name: 'Vendor Updated', value: 'VENDOR_UPDATED' },
],
default: [],
description: 'The event types to subscribe to (replaces existing selection)',
},
];
export async function execute(
this: IExecuteFunctions,
itemIndex: number,
): Promise<INodeExecutionData> {
const webhookSubscriptionId = this.getNodeParameter('webhookSubscriptionId', itemIndex) as string;
const endpointUrl = this.getNodeParameter('endpointUrl', itemIndex, '') as string;
const selectedEvents = this.getNodeParameter('selectedEvents', itemIndex, []) as string[];
const query = `
mutation UpdateWebhookSubscription($input: UpdateWebhookSubscriptionInput!) {
updateWebhookSubscription(input: $input) {
webhookSubscription {
id
endpointUrl
selectedEvents
createdAt
updatedAt
}
}
}
`;
const input: Record<string, unknown> = { webhookSubscriptionId };
if (endpointUrl) input.endpointUrl = endpointUrl;
if (selectedEvents !== undefined) input.selectedEvents = selectedEvents;
const responseData = await proboApiRequest.call(this, query, { input });
return {
json: responseData,
pairedItem: { item: itemIndex },
};
}