update_mcp_integration

Instructions

Implementation Reference

• src/tools/mcp-integrations.tools.ts:309-335 (handler)

  The MCP tool handler for 'update_mcp_integration'. It extracts id and custom_headers from params, calls service.mcpIntegrations.updateMcpIntegration(), and returns a success message.

  server.tool(
  	"update_mcp_integration",
  	"Update an MCP integration's name, description, URL, auth, or transport. Changes apply immediately and altering url or auth_type can break connected clients; use update_mcp_server when you only need to rename or re-describe a server.",
  	MCP_INTEGRATIONS_TOOL_SCHEMAS.updateMcpIntegration,
  	async (params) => {
  		const { id, custom_headers, ...rest } = params;
  		await service.mcpIntegrations.updateMcpIntegration(id, {
  			...rest,
  			...(custom_headers ? { configurations: { custom_headers } } : {}),
  		});
  		return {
  			content: [
  				{
  					type: "text",
  					text: JSON.stringify(
  						{
  							message: `Successfully updated MCP integration "${id}"`,
  							success: true,
  						},
  						null,
  						2,
  					),
  				},
  			],
  		};
  	},
  );

• src/tools/mcp-integrations.tools.ts:63-82 (schema)

  Zod schema for the updateMcpIntegration tool, defining optional fields: name, description, url, auth_type, transport, custom_headers, plus the required id.

  updateMcpIntegration: {
  	id: z.string().describe("The MCP integration ID or slug to update"),
  	name: z.string().optional().describe("New display name"),
  	description: z.string().optional().describe("New description"),
  	url: z.string().optional().describe("New URL endpoint"),
  	auth_type: z
  		.enum(["oauth_auto", "headers", "none"])
  		.optional()
  		.describe("New authentication type"),
  	transport: z
  		.enum(["http", "sse"])
  		.optional()
  		.describe("New transport protocol"),
  	custom_headers: z
  		.record(z.string(), z.string())
  		.optional()
  		.describe(
  			"New custom headers for authentication. Sent via configurations.custom_headers",
  		),
  },

• src/tools/mcp-integrations.tools.ts:309-335 (registration)

  Registration of the tool via server.tool('update_mcp_integration', ...) inside the registerMcpIntegrationsTools function.

  server.tool(
  	"update_mcp_integration",
  	"Update an MCP integration's name, description, URL, auth, or transport. Changes apply immediately and altering url or auth_type can break connected clients; use update_mcp_server when you only need to rename or re-describe a server.",
  	MCP_INTEGRATIONS_TOOL_SCHEMAS.updateMcpIntegration,
  	async (params) => {
  		const { id, custom_headers, ...rest } = params;
  		await service.mcpIntegrations.updateMcpIntegration(id, {
  			...rest,
  			...(custom_headers ? { configurations: { custom_headers } } : {}),
  		});
  		return {
  			content: [
  				{
  					type: "text",
  					text: JSON.stringify(
  						{
  							message: `Successfully updated MCP integration "${id}"`,
  							success: true,
  						},
  						null,
  						2,
  					),
  				},
  			],
  		};
  	},
  );

• src/services/mcp-integrations.service.ts:163-169 (helper)

  Service method updateMcpIntegration() that sends a PUT request to /mcp-integrations/{id} with the update data.

  async updateMcpIntegration(
  	id: string,
  	data: UpdateMcpIntegrationRequest,
  ): Promise<{ success: boolean }> {
  	await this.put(`/mcp-integrations/${this.encodePathSegment(id)}`, data);
  	return { success: true };
  }

• src/services/mcp-integrations.service.ts:55-64 (schema)

  TypeScript interface UpdateMcpIntegrationRequest defining the shape of the update payload (name?, description?, url?, auth_type?, transport?, configurations?).

  export interface UpdateMcpIntegrationRequest {
  	name?: string;
  	description?: string;
  	url?: string;
  	auth_type?: string;
  	transport?: string;
  	configurations?: {
  		custom_headers?: Record<string, string>;
  	};
  }