Better Auth MCP Server

Instructions

Implementation Reference

• src/index.ts:245-258 (handler)

  Handler for the 'generate_migration_plan' tool. Extracts 'projectPath' and 'currentAuthType' from arguments, logs the action, and returns a placeholder response indicating a migration plan has been generated.

  case "generate_migration_plan": {
    const { projectPath, currentAuthType } = request.params.arguments as {
      projectPath: string,
      currentAuthType: string
    };
    logger.info(`Generating migration plan for ${currentAuthType}`);
    // Implementation would create migration steps based on current auth
    return {
      content: [{
        type: "text",
        text: `Migration plan generated for ${currentAuthType}`
      }]
    };
  }

• src/index.ts:116-130 (schema)

  Input schema definition for the 'generate_migration_plan' tool, specifying 'projectPath' and 'currentAuthType' as required string properties.

  inputSchema: {
    type: "object",
    properties: {
      projectPath: {
        type: "string",
        description: "Path to the project root"
      },
      currentAuthType: {
        type: "string",
        description: "Current authentication system type",
        enum: ["auth.js", "next-auth"]
      }
    },
    required: ["projectPath", "currentAuthType"]
  }

• src/index.ts:113-131 (registration)

  Registration of the 'generate_migration_plan' tool in the ListToolsRequestHandler response, including name, description, and input schema.

  {
    name: "generate_migration_plan",
    description: "Create step-by-step migration plan from existing auth to Better-Auth",
    inputSchema: {
      type: "object",
      properties: {
        projectPath: {
          type: "string",
          description: "Path to the project root"
        },
        currentAuthType: {
          type: "string",
          description: "Current authentication system type",
          enum: ["auth.js", "next-auth"]
        }
      },
      required: ["projectPath", "currentAuthType"]
    }
  },