Plugins Overview

import { Plugin, PluginContext, ToolHooks } from '@frontmcp/sdk';

@Plugin({
  name: 'my-plugin',
  description: 'My custom plugin',
})
export default class MyCustomPlugin implements ToolHooks {
  // Called before tool execution
  async beforeToolCall(ctx: PluginContext) {
    // Add pre-execution logic (validation, auth, etc.)
    console.log(`About to execute tool: ${ctx.toolName}`);
  }

  // Called after successful tool execution
  async afterToolCall(ctx: PluginContext, result: any) {
    // Add post-execution logic (logging, caching, etc.)
    console.log(`Tool ${ctx.toolName} returned:`, result);
    return result; // Can transform the result
  }

  // Called on tool execution errors
  async onToolError(ctx: PluginContext, error: Error) {
    // Add error handling logic
    console.error(`Tool ${ctx.toolName} failed:`, error);
    throw error; // Re-throw or transform the error
  }

  // Initialize with options
  static init(options?: MyPluginOptions) {
    return new MyCustomPlugin(options);
  }
}